
Using Syquest's newest portable drive — the EZ135 
- with the CoCo and OS-9/63K machines... and a 
comparison with Iomega's ZIP drive. 





Ed Gresick, owner ofDelmar Co. 
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benefactor, is gravely ill 

See story on page 3. 
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I've just got to say it... this is one 
heck of an issue! There is a lot of 
stuff for everyone here... I don't 
think there has ever been a better 
one! PLEASE don't expect me to 
do this good with every issue, I just 
don't think I can (though I will cer- 
tainly try to do even better)! 

Well, that's enough self back pat- 
ting. But I really do think I did a lot 
this time. It was tough squeezing 
everything in. As long as I can keep 
quality articles coming though, they 
will be printed and my job will be 
easier. 

Please don't forget to renew your 
subscriptions and let me know if 
your address changes. And it 
wouldn't hurt to talk your friends 
into subscribing. I know some of 
you get your info from the Internet 
and/or Delphi, but there is a lot of 
info here that wouldn't be available 
through those sources. The maga- 
zine is more portable too. . . you can't 
connect all the time, and you can't 
share a terminal as easy as a maga- 
zine. All information sources are 
complementary. . . no one has every- 
thing. 

On a personal note, we will sorely 
miss Ed Gresick. His wife, Betty, has 
indicated that the business will be 
shutting down, since it required a 
lot of input from Ed. I was espe- 
cially sorry to hear about Ed's health 
situation. I have met and talked with 
Ed several times in Atlanta during 
CoCoFests there. He is a very dy- 
namic individual. I, for one, am very 
sorry to see him leave us. Ed, you 
have been a great help to all OS-9 
users in one way or another, thank 
you for all the support... 

Speaking of CoCoFests, there 



won't be one in Atlanta this year. 
Instead, the Atlanta Computer Sc 
ciety will be hosting a picnic at Stone 
Mountain Park just east of Atlanta. 
This will be held October 5th. I will 
be there taking magazine subscrip- 
tions and renewals, and other ven- 
dors are invited to come show there 
wares also. The only thing that is 
missing is electricity, so we can't 
demonstrate any programs or hard- 
ware. Oh yes, the picnic is planned 
to start at 10a.m., and you'll need 
to let ACS know if you will be eat- 
ing. Contact them at: ACS, P.O. Box 
80694, Atlanta, GA 30366; BBS 
404-636-2991. There is a $5 en- 
trance fee to the park which will be 
reimbursed to ACS members. I'll 
have details as to the location of the 
pavilion, directions to the park, 
accomodations, etc., in the next is- 
sue. If you need it before then, con- 
tact ACS. All CoCo/OS-9/OSK cl 
thusiasts are invited to attend! This 
year, come to Atlanta and have some 
fim as well as talk about your fa- 
vorite system(s)! Stone Mountain 
Park is an excellent family park, with 
plenty of attractions for all. There 
is also a campground in the park. 
Hope to see you there... 

Colin McKay at Northern Expo- 
sure is making some of the AT key- 
board adapters. They are making 
only one short run, so if you want 
one, contact him at the address in 
the NX ad in the back, or contact 
Ken Scales via e-mial: 

kscales@delphi.com 

Well, that about sums everything 
up this time. I've really worked hard 
on this issue, and had to work fa 
to get it out in time. Hope IBftK t 
miss anything! See you-aMi a 
couple months! -jjj^ 
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Messages from our readers.., 



Dear Frank, 

Enclosed is my renewal for "68' micros'' and the 
disk. Any change you make to "68' micros" magazine 
I am sure will be for the best - it's always a pleasure to 
read it 1 don't know how long CoCo's are still going 
to be still in use - it's such a nice machine - although 
every once in a while it dos sort of act up! But a clean- 
ing of the drives and new disks bring it back to good 
behavior. 

Best wishes to you and your family! Till next is- 
sue... 

Mrs. L Bouit 

330 Metcalfe St, Apt 403 

Ottawa, ON K2P 1S4 (Canada) 

Mrs. Bouit, thanks for the kind words! 1 do try to 
change things only for the best. As long as I have 
enough subscribers like you, the CoCo will always 
be a big part of this magazine, of that you can be 
surel 



I just received my first issue of 'the world of 68 
micors" and I must say that I am quite happy with it 
Regarding your editorial, have you considered bring- 
ing in the Atari ST, Amiga, and even Macintosh crowds. 
I'm not talking about general or advocacy either, I 
mean real techinal articles dealing with real work ap- 
plications. That's just my $0.02 though. Hope things 
continue to go well 

Jim Cox 
jimc(gamc.com 

Well Jim, I have considered bnngtng in some of 
the other makes. Of those you listed, I have really 
only considered the Atari ST/TT series. That may be 
an idea., what do you other readers think? There are 
two reasons I am thinking of maybe adding Atari sup- 
port. The first is that it is an orphan just like the CoCo, 
but still very useful. The second reason is that there 
is a version ofOS-9 that is affordable that runs on it. 



This was still available at least a couple years ago. 
though the company offered no support with the prod- 
uct (about $200 US). There is also a possibility that 
programs written for it could be ported the MGR sys- 
tem, and hardware could be developed for both sys- 
tems also (the Atari has a built in SCSI port, I think). 
I'd defmately like to hear from readers on this. 
Would you mind sharing space with another 68K 
based computer? 




Non-Blocking I/O In OS-9/68K 

What is the best way to do nonblocking 10 in OS-9/68000? 



Russell Keller 



I have a do loop that I want to execute continuously and ac- 
cept keyboard charcter inputs should the user happen to hit a 
key. Functions like getc block until a user inputs a value. On 
other systems I have used a kbhit() function that lets the pro- 
gram know if there is anything in the buffer. Is there a similar 
OS9 function? 

One way to handle keyboard input is to use _gs_rdy() to 
determine if there is any data available. 

char input_buffer[l]; 

do{ 

if (_gs_rdy(keyboard_path)>0) { 

read(keyboard_path,input_buffer, 1); 
do_something_with_data(); 

} 
else 

do_other_chores(); 

} 

/* error checking ommited */ 



__gs_rdy() is not useful for getcO or other buffered calls and 
should be used with that in mind. 

Another way is to make a signal based routine to send a signal 
when data is available. You may sleep() until data is available 
or use an interceptO routine to catch the signal and then fetch 
the data. This technique is useful in a complex environment 
such as multiple inputs or real time handleing of inputs. The 
signal system has a lot of flexibility and can simplify a complex 
set of inputs. One major benefit of the signal system is to allow 
the process to sleepO while no activity is occuring and allow 
other processes to use the cpu time. A programming technique 
of using a separate process to handle each input and sleepO be- 
tween signals is very useful. 

OS-9 can do it. It is like golf clubs. It takes practice. Have fun! 



krussell@callruss.com 







Many of you know Ed Gresick. He has supported OS-9/68K for a number 
of years through Delmar Co., which he owns. It is with sadness that we learned 
that he was hospitalized early in July with what appeared to be a stroke. This 
has turned out to be associated not with a stroke, but with cancer. The cancer 
is definately terminal, and he is not expected to live more than a few more 
months. I hope you all join with me in praying for him and his wife Betty. 
Cards may be sent to: Delmar Co., P.O. Box 78, Middletown, DE 19709 
Please let his wife know that he will be sorely missed and is well respected by 
the CoCo/OS-9 community. 
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Removeable Hard Drives Made Easy 

Use a Syquest EZ135 for OSK or CoCo... but not Iomega's ZIP. . . 



Allen Huffman 



One of the largest problems facing or- 
phan computer hobbyists is reliability of 
old hardware. Many CoCo users are still 
relying on 1980s vintage XT based MFM 
hard drives, as well as 10+ year old ex- 
pansion devices. Unfortunately, there isn't 
much one can do to "update" equipment 
that hasn't even been manufactured in 
ages. A partial solution does exist, how- 
ever. 

In 1995, two new removeable hard drive 
units were introduced to the market. 
Iomega brought out their ZIP drive, offer- 
ing 100 megs of storage on compact floppy 
style disks, and then, later, SyQuest intro- 
duced their 135 meg removable E2135 
unit. Both were targeted at the PC and 
Macintosh market, with external SCSI 
models as well as parallel port units. Both 
are tiny units with their own power sup- 
plies and quiet operation (no noisy fan). 
To a Color Computer or OS-9/68000 ma- 
chine owner the SCSI models hold par- 
ticular interest. 

Hard Drive Interfaces 

There are three primary models in use: 
MFM/RLL (an older format, no longer 
produced, originally used for early PC/XT/ 
AT machines), SCSI (old, but still in use 
and standard on most high-end or non- 
PC machines), and IDE (the current PC 
standard). Both SCSI and IDE also have 
more advanced versions such as SCSI-2, 
Wide SCSI, and Enhanced IDE. For the 
CoCo market, interfaces exist to support 
MFM/RLL and SCSI For OS-9 machines, 
SCSI is the most common, though the 
AT306 system does come with a built in 
DDE interface. This article will focus spe- 
cifically on SCSI hard drives. 

An MM/1 owner will have no problems 
hooking up virtually any type of SCSI hard 
drive, but the Color Computer has a few 
restrictions. None of the CoCo SCSI in- 
terfaces seem to support hardware parity. 
Most SCSI drives have a jumper to enable 
or disable the use of this parity bit, but 
any drive that requires it will not be of 
use on the CoCo. The Iomega ZIP drive is 
one such example. The forced use of par- 
ity would require a hardware modification 
on a Disto, LR-Tech, or Ken-Ton style 
SCSI interface (a simple, one-chip modi- 
fication if anyone will bother to design it). 
The MM/1 has no problems using a ZIP. 



Another issue is sector size. Virtually 
all modern SCSI drives use 512-byte sec- 
tors. Again, OS-9/68K machines should 
have no problems with this since their 
drivers support different sector sizes. CoCo 
software typically expects 256-byte sectors. 
What this means is that under the CoCo, 
half the hard drive will not be useable. In 
past years, OS-9 Level 2 drivers were re- 
leased that will support 512-byte sector 
drives. Matt Thompson's SCSISYS is the 
solution, allowing a CoCo OS-9 user full 
use of their 5 12-byte drive. Other drivers, 
and items such as RGB-DOS or Hyper 1/ 
O, are coded only for 256-byte sectors and 
won't make full use of provided storage - 
but they will work. 

Lastly is SCSI ED support The standard 
allows for IDs through 7. Each SCSI 
device must have it's own ID. For ex- 
ample, two hard drives might be hooked 
up as SCSI ED #0 and SCSI ID #1. Not 
all driver software supports the full set of 
IDs. Once again, most OS-9/68K software 
will have no problems with this but the 
CoCo may. SCSISYS, for instance, only 
supports two bits for ID selection, giving 
you access to ID through 3 . The Iomega 
ZIP drive supports ONLY SCSI ID #5 and 
#6, making it useless even if we did have 
an interface that supported hardware par- 
ity. Older drivers, such as the ones de- 
signed for the original Ken-Ton, will sup- 
port the full ID range but do not make use 
of 512-byte sectors. The delima is obvi- 
ous. Even with the proper hardware, there 
would still be a software problem. 

One final ZIP tidbit is that all internal 
media control is done through SCSI com- 
mands. A ZIP disk can be password or 
write protected through software. Unfor- 
tunately, the ZIP tools to do this haven't 
been made available for OS-9 yet which 
means if you were given a write protected 
ZIP disk you would not be able to use it 
without first low-level re-formatting it. 
Same goes for a password protected disk. 
The point is this: ZIP isn't for the CoCo. 
Proper use would require new hardware 
and software. 

The Syquest EZ1 35 

With all of this in mind, the focus is 
turned to the SyQuest unit. The EZ135 
fixes everything that seems wrong with the 
ZIP. The EZ doesn't require hardware 



parity and, while it does use 5 12-byte sec 
tors, it allows you to select any SCSI IL 
for the unit, meaning Matt Thompsons 
drivers will work great. Also, unlike the 
ZIP drive with DB25 Mac style SCSI 
ports, the EZ uses two full sized 50-pin 
SCSI connectors on the back and even 
comes with a terminator plug which must 
be put on the last unit in the chain of de- 
vices. There are also several major advan- 
tages to the EZ over ZIP. First is speed. 
The ZIP emulates a high-speed floppy 
This makes the cartridges very rugged, but 
also very slow compared to a hard drive. 

In speed tests, the ZIP transfered 90K a 
second on a non-accelerated MM/1 (68070 
at 16mhz). The EZ135 transfered about 
L5 megabytes per second on the same 
machine. CoCo speed tests could not be 
made against the ZIP, but when compar- 
ing the EZ135 to a Quantum ProDrive 
2 10S (250 meg SCSI hard drive), the pub- 
lic domain SCSISYS 1.0 drivers read 1 
meg in 3 1 seconds on the EZ versus 26 
seconds from the Quantum. This seems 
to indicate the EZ being slower than the 
Quantum, but running the same test aga ; 
using the commercial SCSISYS 2.0 driv 
ers resulted in 1 meg in 12 seconds from 
the Quantum or the EZ. That's quite a dif- 
ference! (editor; SCSISYS 2.0 uses a cache 
to buffer the hard drive I/O — much like 
SmartDrive for you Windows users — 
which makes it extremely fast) 

As you can see, the EZ is more like a 
true removeable drive, giving hard drive 
speeds with the downside of the media 
being a bit more fragile. For OS-9/68K 
users, if sending media through the mail 
was important and speed was not, the ZIP 
would seem to be better suited. Also, the 
ZIP is a bigger "standard" in the PC and 
Mac worlds making media easier to find. 
For everything else, the EZ seems to win 
hands down, (editor: If you do any desk- 
top publishing, it is worth noting that the 
older, more delicate Syquest drives are pre- 
ferred for sending large files.) 

Storage Limitations? 

One really nice thing is the unlimited 
storage potential for removeable units sue** 
as these. 135 megs on a CoCo is enou L 
room for 256 RGB-DOS partitions as well 
as 52 megs for OS-9. If that gets full, but 
additional EZ disks at about $20 each. 
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Also, an EZ drive moves grace! ully be- 
tween the CoCo, MM/1, PC, Mac, Amiga, 
and just about anything else that supports 
SCSI hard drives. A multiple machine 
owner no longer has to buy a dedicated 
drive for each machine they own. 

As you can see from the specs in the 
sidebar, the EZ 135 really seems to be the 
better unit overall A recent reduction in 
retail price to $120 makes it the cheaper 
of the two also. If storage size is impor- 
tant, another option might be the new EZ 
Flyer 230 meg removeable (which also 
reads and writes EZ135 disks) or the up- 
coming SyJet 1.6 gig removeable. Iomega 
also offers the 1 gig removeable J AZ drive 
for about $500 which has a different de- 
sign and is reported to be much faster than 
ZIP and can use the full set of SCSI ids. 
The options are there, but it's difficult to 
ignore a $ 120 removeable media solution. 

Summary: 

If a drive for a CoCo is your only 
insterest, the EZ135 is the winner. If an 
MM/1 or other OS-9/68K system is your 
only interest, and widely used, rugged, 
mail-proof media is important, check into 
the ZIP, Remember, either of these can be 
used on any other machine with a SCSI 
port, so your drive can migrate with you 
should you change or can be used on all 
machines with different cartridges. 

Using the EZ135 Drive on a CoCo 

During experimentation with the EZ135 
removeable hard drive on ray CoCo, I found 
some tips that may be of interest to others. 

How Big the EZ135 REALLY Is 

Before getting started, let me mention that 
while the drive is promoted as a 1 35 megabyte 
unit, it only provides 262,144 sectors. Each 
sector is 512 bytes, giving a total of 
1 34,2 17,728 bytes of total storage. Depending 
on your definition of "megabyte", your milage 
may vary. Assuming 1000 bytes per K, and 
1000K per meg, this is just under 135 megs. 
This is apparently SyQuest's definition of a 
megabyte. 

If you prefer the more ''accurate" computer 
definition, with IK being 1024 bytes, and 
1024K per meg, then this unit gives exactly 
128 megabytes of storage. For the sake of this 
discussion, we will use this definition since, 
mathematically, 1 35 megs will NOT work for 
the calculations I wih be using. 

About RGB-DOS 

RGB-DOS is a patch that allows Disk BA- 
SIC to use a hard drive. It works by intercept- 
ing floppy disk i/o and converting that into hard 





SvOuest EZ135 


lomeea ZIP 


Average Seek Time 


13.5 


29ms 


Max Transfer Rate 


4mb/sec 


1.4mb/sec 


Typical Transfer 


1.4 -2,4mb/sec 


lmb/sec 


MTBF 


200,000 hours 


100 7 000 hours 


Storage 


135mb/disk 


lOOmb/disk 


Unit Warranty 


2 years 


1 year 


Disk Warranty 


5 years 


Limited lifetime 


Power Switch? 


Yes 


No - Unit is always on 


Connectors 


2 50-pin SCSI 


2 DB25 SCSI 


SCSI ID Range 


through 7 


5 or 6 only 


Street Price 


$120 


$200 



drive calls. Typically, you access a floppy by 
reading or writing a particular sector of a par- 
ticular track of a particular drive. RGB-DOS 
allows for drive numbers through 255, and 
splits them up into "virtual drives" on the hard 
disk. One can switch between the "real" floppy 
drives 0-3 or the virtual drives through a spe- 
cial command. Virtual drives 4-255 mat be 
accessed along with the four physical floppys. 

If your main interest is RGB-DOS, one 
EZ135 disk will give you room for 256 RS- 
DOS drives (and still have 50 megs left over 
for OS-9 use). The EZ135 has $40000 
(262, 144) sectors. Each RS-DOS disk takes up 
630 sectors as follows: A drive is 35 tracks in 
size. A track is 18 sectors long. 35 tracks * 18 
sectors per track = 630 sectors per disk (630 
sectors * 256 bytes per sector = 16 1280 bytes.) 

The EZ135 uses 512-byte sectors, but RGB- 
DOS doesn't know how to deal with them. 
RGB-DOS will simply use the first 256 bytes 
of each physical sector on the drive, wasting 
the r emaining 256 bytes. RS-DOS "sees" it as: 
630 sectors * 256 bytes per sector = 161280 
bytes. However, the drive is actually storing it 
as: 630 sectors * 5 12 bytes per sector = 322560 
bytes. 

If you multiply this out for 256 disks, you 
will see that you are wasting 4 1 ,287,680 bytes 
of storage (about 40 megs). To remedy this 
would require a rewrite to RGB-DOS to use 
512-byte sector drives (using 315 512-byte 
sectors per RS-DOS drive). Further rewrites 
might allow partitioning a hard drive into mul- 
tiple banks, meaning a 135 meg drive might 
be able to allow three virtual banks of 256 RS- 
DOS disks each with 15 megabytes left over 
(possibly partially used by a fourth bank of 64 
drives) for a total of 832 RS-DOS disks on one 
drive! It is, of course, very unlikely that any 
such rewrites will ever be made. Plus, with 
EZ1 35 disks being $20 each, why put all your 
eggs (software) in one basket (drive) anyway? 
Instead, I'll preset everything you need to get 
the most out of existing software and hardware, 
including some useful programs to get more 
out of RGB-DOS. 



OS-9 and RS-DOS - A Skitzo Disk 

If you wish to use the EZ1 35 disks for both 
OS-9 and RS-DOS you need to be aware of 
how both operating environments work. OS-9 
typically expects the disk structure to start at 
the first sector of the drive. While changing 
this could be done, it would require modifica- 
tions to the low level boot routines as well as 
higher level drivers. The drivers would have 
to be coded to add an "offset" to every di^ks 
access. Typically OS-9 would look for sectors 
through MAX, where MAX is the total num- 
ber of sectors on the device. Putting OS-9 fur- 
ther into the disk, say, starting at sector 1000, 
would require every disk i/o to have 1000 
added to it. Reading sector would end up 
reading sector 1000, and so on. This would 
make the driver slightly slower (Matt 
Thompson's SCSISYS 2.0 commercial drivers 
actually do support this, but mainly for parti- 
tioning large hard drives into smaller virtual 
sections. ) 

Instead of this, it's easier to let OS-9 have 
the first portion of the hard drive like it wants, 
and force RS-DOS to step over it. RGB-DOS 
allows you to specify an "OS-9 Offset" which 
will be added to every disk access made. By 
default, RGB-DOS expects RS-DOS drive 
to exist as sectors through 629 (630 sectors). 
Drive 1 would be at sectors 630 through 1259, 
and so on. By adding an offset, RGB-DOS 
can be made to access these virtual drives fur- 
ther into the drive in a similar manner as 
discused above with OS-9 drivers. 

Before starting, you must decide how much 
room you want taken up for RS-DOS disks, 
with whatever is left over for OS-9. Decide 
how many drives you want and multiply that 
number by 630. This will tell you how far back 
from the end of the drive the RS-DOS section 
will begin. To simplify, think of it like this: 

Suppose you had a drive with 100 sectors 
(numbered through 99) and that each RS- 
DOS disk took only one sector. If you wanted 
it setup for 40 RS-DOS disks, they would start 
at sector 60 and go through 99, leaving sectors 
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through 59 for OS-9. Hie same Liuiig applies 
here, except there are more total sectors and 
the RS-DOS partitions are 630 sectors instead 
of 1. 

If you want the largest amount of space for 
RS-DOS (256 drives), you would take 256 
drives times 630 sectors per drive which would 
give you 161,280. This is how many sectors 
they would take up. Movmg back from the 
"end" of the hard disk by subtracting this value 
from the total number of sectors gives you 
100,864 (262,144 total sectors minus 161,280 
sectors). Since sectors start with 0, you'd need 
to subtract 1 from that value to get the actual 
starting sector: 100,863. Converting this into 
HEX is $ 1 89FF. This becomes the "OS-9 Off- 
set" for RGB-DOS to use. Three memory lo- 
cations inside RGB-DOS will contain $1 , $89, 
and $FF. Then, everytime RGB-DOS goes to 
access a sector, it starts at this location rather 
than the start of the drive. 

That takes care of the RGB-DOS side of 
things, but there is still the issue of letting OS- 
9 know how much drive space it actually has 
available. The drive must be formatted cor- 
rectly so that it doesn't overwrite the RS-DOS 
area. To do this, you must "lie" to OS-9 and 
tell it the drive has fewer sectors than what it 
really has. In this example, we know that sec- 
tors through 100,863 can be used for OS-9 
so we have to tell OS-9 to logically format the 
start portion of the hard drive with just that 
many sectors. This is not as easy at is sounds, 
since the FORMAT utility bases what it does 
on entries in the device descriptor. 

Format calculates the total number of sec- 
tors on the drive by multiplying the number of 
sides times the number of sectors per cylinder 
times the total number of cylinders on the de- 
vice. Since I was using 100,863 512-byte sec- 
tors, I would normally have wanted values 
which produced that. HOWEVER, since I am 
using Matt Thompson's drivers which make 
full use of 512-byte sector drives I must do 
something different. 

SCSISYS does a neat trick to keep OS-9 
happy. It makes two "logical sectors" from each 
physical sector on the device. Thus, physical 
5 12-byte sector becomes logical sectors and 

1 to OS-9. Physical sector I is logical sectors 

2 and 3, and so on. This must be realized since 
if you tell format how many physical sectors 
are there, it will only format half the space, 
(ie, 100,863 physical sectors remain, which is 
actually 201,726 logical sectors forOS-9.) So, 
I have my descriptor setup as follows; 

sectors = 42 

cylinders = 1601 

42 ♦ 1601 • 3 = 201,726 logical sectors 

sides = 3 

I changed my /HO descriptor using the 
DMODE utility. The version I use accepts both 
hex or decimal entries, but I'll list both just in 
case you have an older version that does not: 

Decimal values: 



dmode /h0 sci=42 tos=42 

cyl=l602sid=3 

Hex values: dmode /h0 sct=$2a 

tos=$2acyI=$641 sid~$3 

My /HO descriptor for SCSISYS now looks 
like this: 

adr=$FF74 drv=$00 stp=$00 typ=$80 

dns=$80 cyl=$0641sid=$03 vty=$00 

sct=$002A tos=$002A ilv=$01 sas=$08 

After this, you can format the OS-9 portion 
of the drive by doing a LOGICAL format: 

0S9: format /h0 

COLOR COMPUTER FORMATTER 

Formatting drive /hi 

WARNING: You are formatting 

a HARD Disk,. 

y (yes) or n (no) 

Ready? [type S Y' here] 

WARNING: You are formatting 

a HARD Disk.. 

Are you sure? Ctype V Y' here] 

Both PHYSICAL and LOGICAL 

format? Ctype V N' here] 

Disk name: 

[enter disk name and proceed] 

Then the logical format will complete cre- 
ating LSN0, the file allocation bitmap, and the 
root directory. From this point on you should 
be in good shape with approximately 50 mega- 
bytes of storage for OS-9. 

NOTE: If you are not using SCSISYS, and 
your OS-9 drivers do not support 5 1 2-byte sec- 
tors, you can still do this by using the actual 
amount of "left over" sectors (100,863). This 
gives you about 25 megs for OS-9. Changing 
the "sectors" value to 21 should suffice. 

If you are wanting to experiment with other 
combinations of OS-9 and RS-DOS partition- 
ing, I have created a basic program to help. In 
order to use it, you must know how many sec- 
tors your hard drive has, as well as if it is a 
512-byte or 256-byte drive. To find the num- 
ber of sectors, you can run the program HD- 
UTILS.BIN included on the RGB-DOS disk. 
LOADM and EXEC it, then select <F>ind Pa- 
rameters from the main menu. It will show you 
a screen of information, including the actual 
number of physical sectors the drive supports. 
As an alternative, you can run SCSIFMT un- 
der OS-9 and have it query the drive size for 
you: 

0S9: scsifmt 

»> SCSI SYSTEM FORMATTER 1.0 <« 

Copyright (C) 1993 by Matthew Thomp- 
son 

P) Physical Format/Verify 
L) Logical Format 
Q) Quit 

Ctype V L' here] 

CAUTION: THE ROOT DIRECTORY 
ON THE DRIVE WILL BE LOST! ! ! 
YOU MUST MAKE A BACKUP IF 



YOU WANT TO KEEP THE FILES!!! 



Which device: / 




Ctype your descriptor 


name here, such 


as v h0'] 






2) 


Drive Number: 





4) 


512 Flag: 


1 


5) 


SCSI ID: 





6) 


SCSI LUN: 





7) 


Err Type Flag: 





8) 


Cluster Size: 


1 


C) 


Cylinders: 


1601 


D) 


Heads: 


3 


E) 


Sectors/Track: 


42 


G) 


Segment Size: 


8 


I) 


Device Name: 


hO 



Continue (Y/N)? Ctype N y' here] 

Query drive size (Y/N)? 
Ctype v y' here] 

1) Disto, 2) Ken-Ton/LR-Tech? 
Cselect your interface here] 

Port address - 1) $FF74 (regular), 2) 
$FF70 (alt) [and port address] 

Watch which drive light flashes to make sure 
you 've got the right one. Hit any key. 

Total logical sectors: S07FFFE 

Ready to begin. Everything OK (Y/N)? 

Ctype s n' here] 

Cthen v q' to quit from the main screen] 

Notice that on the EZ135 scsifmt actually 
returned the number of 256-byte sectors the 
unit will end up providing. On a 5 12-byte sec- 
tor drive, you would really want to use half of 
this value. 

Once this value is known, you can use the 
program OS9PART.BAS (listed below) to cal- 
culate the correct RGB-DOS offset and also 
modify the binary RGB-DOS image to support 
it. This is a replacement for the program OFF- 
SET-9.BAS included with RGB-DOS. 

REM * 

1 REH * R6B-D0S/0S-9 PartUtil V1.0 

2 REM * by Allen C. Huffman 

3 REN * (formerly of Sub-Etna Software) 

4 REM * 

5 REM * This program wilt calculate the 

6 REM * RGB-DOS offset needed to split 

7 REM * the hard drive between OS-9 and 

8 REM * RS-DOS. (Replaces 0FFSET-9.BAS) 

9 REM * 

10 PCLEAR1 :PALETTE0,0:PALETTE8,63 
WIDTH40:CLS1 

15 PRINT1RGB-DOS only uses 256-byte sec- 
tors. If your hard drive only supports 
512-byte secotrs, RGB-DOS will only use 
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Co Co Disk Tester 

Mark bad sectors on floppies to reduce read/write errors. 



Robert E. Bruhl 



In January 1985, the RAINBOW magazine printed a listing 
and text for a program named DISKTEST.UTL by Charles C. 
Zimmer, This program looks for bad granules by doing a thor- 
ough test of the disk by writing and reading all tracks with dif- 
ferent data patterns. The test is created to effect the worst-case 
situations for data patterns and head positioning, so that this is 
not only a test of the diskette material itself but also a test of the 
head positioning accuracy of the disk drive. I modified the pro- 
gram to test 40 tracks and renamed it "DSKTST40.UTL". 

If bad granules are found, the program creates a file called 
DEFLOG.###. The ### is the diskette number (000-999). All of 
the bad granules are assigned to this file. In this way these 
granules are effectively taken out of use and the disk can still be 
used for other things. 

If you have a printer, a one line report can be created showing 
which granules are bad. The program was originally written for 
an OKJD ATA 92 printer. I redid the printer routine for use with 
a DMP130 series printer. I use this program to check out all of 
my disks before using them. If the directory track is bad, I throw 
the disk away. If other granules are bad, I can always use the 
disk as a work diskette. 

HOW THE PROGRAM WORKS 

The program starts out by asking you to turn up the volume 
and then to press any key to continue. It then asks you to enter 
the drive number (0-3) and goes to the next message. The next 
message has you enter a "S" for a short test or anything else for 
a full test. The next message wants a "P" for a printout or any- 
thing else to continue. If a "P" is entered, the program then asks 
for a date (YYMMDD). At this point you are given the chance 
to "INSERT OF CHANGE DISKETTE". Put in a diskette and 
press "C" to commence the test or press "Q" to quit the pro- 
gram. If "C" is entered, the next message asks for the DIS- 
KETTE NUMBER (###). If no number is entered, 000 will be 
used. The program then starts the testing process by showing 
"OPERATION: FILE CHECK" and checking the directory track. 
If the directory track is bad, the message "DIR. TRACK ER- 
ROR-CAN'T CONTIN." "(ANY) TO RESTART OR QUIT*. 
If the directory track is good, the program informs you whether 
or not the disk has files and if a defect log is present or not. If 
this disk has files, now is your chance to change disks in case 
this is a good disk. 

At this point you are at the "FIRST DEFECT CHECK POINT" 
and the first 70 granules are shown on a defective granule map. 
You may either (E)nter changes or (C)ontinue. If you want to 
manually enter or delete defective granule numbers, you can do 
it at this time or you can continue. Entering a number less than 
or greater than 77 will get you an "INVALID ENTRY" mes- 
sage. Pressing any key will get you back to the screen that asks if 
you want to continue or to enter changes. If you continue, the 
screen will be cleared and a new defective granule map will be 
drawn showing the last 8 granules. After all of the testing is 
complete, the program will return to the start of this paragraph, 
but then it will be called the "FINAL DEFECT CHECK POINT" . 

The program will now display 4 lines showing which cycle 
(1-6), track (0-39), granule (0-67,DIR) or operation (WRITE- 



FIGURE 1: READ, WRITE & POSITIONING SEQUENCES 




PATTERN & SEEK DIRECTION 




CYCLE* OPERATION EVEN TRACKS ODD TRACKS 


INTERLEAVED ROTATING WORST-CASE PATTERN TEST 


K*) 


WRITE DB6 


IN 




WRITE 6DB 


OUT 




Read track only, to set up for next 






READ 


IN 




READ OUT 




2(») 


WRITE B6D 


IN 




WRITE 6DB 


OUT 




READ 


IN 




READ OUT 




3(*) 


WRITE B6D 


EN 




WRITE DB6 


OUT 




Read track only, to set up for next 






READ 


IN 




READ OUT 




INTERVEAVED 1,0 TEST 


4(1) 


WRITE FF 


IN 




WRITE 00 


OUT 




Read track only to set up for next 






READ 


IN 




READ OUT 




5(2) 


WRITE FF 


IN 




WRITE 00 


OUT 




READ IN 






READ 


OUT 


6(3) 


WRITE Directory track only, FF 
(a housekeeping cleanup pass) 




Patterns DB6, 6DB, B6D, FF & 00 are described in the article. 


(#) are 


cycle numbers shown in the short test, 


steps (*) are not 


done in 


the short test. 





READ) is taking place. If a bad granule is incountered, a fifth 
line (BAD GRANULE) will be displayed. After the "FINAL 
DEFECT CHECK POINT' maps have been displayed, the pro- 
gram will go back to the point where you can either insert a new 
disk or end the program. 

SOME TECHNICAL INFORMATION 

The following information isn't needed to run the program, 
but it might be nice to know a little about the disk drive. When 
the drive records data on the disk, it magnetizes the iron oxide 
material under the head. As the disk rotates, the direction of the 
magnetization is switched back and forth according to an encod- 
ing algorithm that is known to the system. The effect is similar 
to small bar magnets laid end to end along the track. They vary 
in length and each successive one is turned around. 
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Later on, when the tracks are read, the 
bar magnets are passed under the head and 
every time a junction of two magnets 
passes under the head the magnetic flux 
through the head reverses and a small volt- 
age is induced into the head. This signal 
is amplified and is sent back to the com- 
puter as the data which was recorded on 
the disk. The important thing is the time 
sequence of these flux reversals. They de- 
termine whether the data is a one or a zero. 

If we want to test the disk, we want to 
put these flux reversals in as many places 
as we can in each track and then read the 
disk to see if they were properly recorded. 
Some flux reversals are harder to recover 
than others, so some good patterns have 
to be used Mr. Zimmer found that the Hex 
patterns DB6, 6DB and B6D produced the 
worst-case flux reversals. Since each of 
these patterns is a 12-bit value, it is sent 
as DB 6D B6, etc. He also used the Hex 
patterns 00 and FF in testing the disks. 
Mr. Zimmer also set the program up to do 
a short test or a long test. The long test 
has 5 cycles that it runs through, while 
the short test uses only the last 2 cycles. 
Each cycle takes about 2 minutes so a com- 
plete test is only 4 or 10 minutes in lenght 
The long test is recommended as it is the 
most complete test. Figure 1 shows what 
is done in each cycle. 

If anyone would like a copy of the ar- 
ticle from the RAINBOW magazine, just 
write to me at the address shown in the 
DSKTST40.UTL program and enclose a 
stamp. I will be glad to send them a copy. 

10 'DISKTEST.UTL 1.1 (C) 1983 BY 
CHARLES C. ZIMMER 101 AUSTIN RD 
SUDBURY, MA 01776 

11 'MODIFIED 1988 FOR 40 TRACK 
OPERATION BY ROBERT E. BRUHL 

12 '841 N. MAPLETON AVE. 

13 'OAK PARK, IL 60302 

14 'NEW NAME DSKTST40.UTL 
15CLEAR200 

20 BC=3:CLSBC 
25GOSUB180:GOTO280 

30 'i/o sub 

35 

POKEPR01 :POKEPP+1 , D1 :POKEPP+2,T1 : 

POKEPP+3,S1:POKEPP+4,4:POKEPP+5,0: 

X=USR0(0):EC=PEEK(PP+6):RETURN 

40 'gran to disp sub 

45 IFX>33THENG=X+2ELSEG=X 

50 IFG(X)=&HFF THENM$=' "ELSEM$= 

RIGHT$(STR$(X) f 2) 

55PL=69+32*INT((G-24*INT(G/24))/2) 

+1 0*INT(G/24)+(G-2*INT(G/2))*3 

60 IFG(X)<>&HE9 HENPRINT@PL, 

USING"%%";M$; 

:RETURNELSEFORX2=0TO1: 

POKE&H0400+PL+X2, ASC(MID$(M$ ( X2+ 



1,1)): NEXT RETURN 

65 'inkey sub — 

70 
K$=INKEY$:IFK$=THEN70ELSERETURN 

75 'pause sub 

80 

PRINT@I1,M1$;:GOSUB70:GOSUB170: 

RETURN 

85 'defect list form sub 

90 CLSBC:PRINT@3,"MAP OF DEFEC- 
TIVE 

GRANULES:";:X3=0:FORX1=34TO54STEP10: 
PRINT@X1,'TK/GR:GR";:FORX2=1T012: 
PRINT@X 

1+32*X2 p USING ,, #r;X3;:PRINr/: 
^X^X>1:NDCTX2X1:PR^@239,PRr;RETURN 

91 CLSBC:PRlNT@3/MAP OF DEFEC- 
TIVE 

GRANULES;';:X1=34:PRINT@X1/TK/ 
GR:GR*; 

92 FORX2=1T04:PRINT@X1+32*X2, 
USING "##*; X3;: PRINT*/ : 
";:X3=X3+1:NEXT: RETURN 

95 'list defects sub 

100 

GOSUB90:FORX=0TO69:IFG(X)=&HB9 

ORG(X)=&H99 ORG(X)=&HE9 

THENGOSUB45 

101 NEXTRETURN 

102 

GOSUB91 :FORX=70TO77:IFG(X)=&HB9 

ORG(X)=&H99 ORG(X)=&HE9 

THENGOSUB45 

103 NEXTRETURN 

1 05 'declare defects sub 

110 PRINT@I3,M3$;"DEFECT ENTRY 

POINT ';:PRINT@I1/<OONTINUE 

<E>NTER DEFECTS ";:PLAYA$ 

115 GOSUB70:IFK$=*C"THEN RETURN 

ELSE IFK$="E'THEN 

GOSUB170:GOTO120 ELSE PLAY 

E$:GOT0115 

120 PRINT@I3,G$;:PRINT@I1 ,"<!#> 

INSERT <D#>DELETE <C>ONTIN';:PLAY 

A$: PRINT© 13, "; : INPUTI$:PRINT@I3+ 

30, F$ ;: L$=LEFT$(l$ f 1):IFL$=*C"THEN 

110 ELSE IFLS^D'ORLS^ITHEN 125 

ELSE GOSUB 155:GOTO120 

125X1=LEN(l$)-1:FORX2=1TOX1: IF 

MID$ 

(l$,X2+1 ,1 )< (, 0' , ORMID$(l$ t X2+1 ( 1)>*9rTHENX 

2=X1:GOSUB155:NEXT:GOTO120 ELSE 

NEXT:l=VAL(RIGHT$(l$,X1)):IFI<0ORI>77 

THENGOSUB155: GOTO120 

130 IFG(I)=&HB9 ORG(l)=&HE9 THEN 

PRINT ©I3/CANNOT OVERRIDE 

TESTED RESULTS - ;: 

PRINT@l1,M1$;:PLAYE$:GOSUB70:GOTO120 

140 IFL$="I"THENG(I)=&H99 ELSE G(l)= 

&HFF 

145 X=l:GOSUB45:GOTO120 

1 50 'invalid resp sub 

155 PRINT@I3/INVALID ENTRY ";:PRINT 

@I1,M1$;:PLAYE$ 

160GOSUB70:RETURN 

165 'msg clear sub 

170 PRINT@I3,C$;F$;F$;C$;:RETURN 

175 'logo sub 

180 PRINT@134/* D I S K T E S T 
*";:PRiNT@224/COPYRIGHT (C) 1983 BY 



CCZ!MMER";:RETURN 
185 'ml load sub 



190 FORX=0TOLEN(P$)/2-1:POKEX1+X, 
VAL("&H"+MID$(P$ 1 1+2*X,2)):NEXT:RETURN 

195 'print question sub 

200 PR1NT@I1;<P>F0R PRINTOUT 

<OTHER> CONTIN';:PUYA$ 

205 GOSUB70:IFK$<>"P"THENP=0: 

RETURN ELSEP=1:PRINT@I1, 'ENTER 

DATE <YYMMDD> ';:PRINT@I3, 

G$;:PRINT©I3,"";:PLAYA$:INPUTD$: 

PRINT@I3+30,F$;:RETURN 

210 'diskette # sub 

215 PRINTQI1, "ENTER DISKETTE 

NUMBER <###> ";:PRINT@I3,G$;: 

PRINT@I3, ' *; :PLA YA$:INPUTDN: LN$= 

LEFT$(LN$,8)+ RIGHT$("000'+ RIGHTS 

(STR$(DN),LEN(STR$ (DN))-1),3): 

GOSUB 170:RETURN 

220 'print id sub 

225 POKE150,18:PRINT#-2,CHR$(27); 

CHR$(23) 

230 PRINT^2,USING"% %d#%% % % "■ 

RIGHT$(LN$,3),D1 ,T$,D$;:RETURN 

234 'print log sub 

235PRINT#-2,TAB(15);:FORX=X1 TO X3: 

IFX2=10THENX2=0:PRINT#-2,CHR$(27); 

CHR$ (83);CHR$(0);CHR$(27); CHR$(14); 

CHR$(27); CHR$(31 );:PRINT#-2,USING 

"#"; X10;: PRINT #-2,CHR$(27); CHR$ 

(32);CHR$(27); CHR$ (15); CHR$(27); 

CHR$(88); 

240 IFG(X)=&HB9 THENPRINT#-2"; 

ELSE IFG(X)=&H99 THEN PRlNT#-2, 

CHR$(34); ELSE IFG(X)=&HE9 THEN 

PRINT#-2,"; ELSE PRINT#-2,USING*T; 

X2; 

245 X2=X2+1:NEXT:PRINT#-2,":RETURN 

250 'drive # sub 

255 PRINT@I1 ."ENTER DRIVE NUMBER 
(0-3) ";:PRINT@I3,G$;:PRINT@I3," 
";:PLAYA$: INPUTD1:GOSUB170:RETURN 

260 'test type sub 

265 PRINT® 11 ,'<S>HORT TEST 
<OTHER> FULL TEST';:PLAYA$ 
270 GOSUB70:IFK$='S"THENT$="Sh": 
RETURN ELSET$='Lg': RETURN 

275 'initialization 

280 I1=481:I3=440:FC=127+16*BC: B$= 

CHR$(128):C$=STRING$(30,FC): F$= 

CHR$ (FC ):G$=STRING$ (30,32): PP= 

26*PEEK (&HC006)+PEEK(&HC007):DI 

MG(79): DEFUSR0=&H0E00: DEFUSR1 = 

&H0E0A: DEFUSR2=&H0E86: B=&H0400 

285 LN$='DEFLOG ":A$="V31;05; L35; 

T50; EP3EP3E":E$='V31;03; L35; T50; 

EP3EP3E" 

290 P$="AD9FC00439 M ;X1=&H0E00: 

GOSUB 190 

295 P$="347FBDB3ED338D002D33CB10 

A E8D0 0236F8D0021 1 F31 A68D001 B81 5 

5 27 0E EC81ED A1A684A7A06C8D000B 

20E8 A684A 7A4357F3904 0O0ODB6DB6 

DB6DOO00OOFFFFFF":X1 =&H0E0A: 

GOSUB190 

300 P$="343FBDB3EDBEC006A702860 

93D4C5 CE7031F02AD9FC004E60627 

10E602 C1112605C C00022 00ECC00 

01 20091 F2O81O926DCCC00O0 BDB4F 

4353F39":X1=&H0E86:GOSUB190:P$=" 
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305 M1$='<ANY> TO CONTINUE 

':M2$="<ANY> TO RESTART OR QUIT " 

310PRINT@I1,M1$; 

315 PRINT@I3,'PLEASE TURN UP 

VOLUME ON TV ";:FORX=1TO150: 

NEXT:PU\YE$:K$=INKEY$: IFK$=" THEN 

320ELSEGOSUB170: GOSUB255: 

GOSUB 265: GOSUB200:GOTO350 

320PRINT@l3/please";B$;"tum";B$;"up"; 

B$ ) "volume w ;B$;'on';B$;V;B$;B$;B$i: 

FORX=1TO150:NEXT:PLAYA$:GOTO315 

325 'dir error abort point 

330 PRINT@I3,"DIR. TRACK ERROR- 
CANT CONTIN.";:lFP=1 THEN GOSUB 
225:PRINT#-2, "DIR. TRACK ERROR- 
CANNOT CONTINUE-DISK NOT USABLE 
OR UNFORMATTED": PLAYE$ ELSE 
PLAYES 

335 'restart point 

340 PRINT@I1,M2$;:GOSUB70:CLSBC 

345 'start point 

350 GOSUB180:PRINT@I1,"<C> 

OMMENCETEST <Q>Uif 

";:PRINT@I3,"JNSERT OR CHANGE 

DISKETTES ";:PLAYA$ 

355 GOSUB70:IFK$="CTHENGOSUB 

170: GOSUB 215: GOT0365ELSE1F 

K$="Q"THEN GOSUB170: PRINT@l3-33 

,";:GOTO 356 ELSE PLAYE$: GOTO 355 

356IFP=1THENPRINT#2,CHR$(27);CHR$ 

(19);CHR$(27);CHR$(54) 

357 END 

360 'file check 

365 GOSUB170:PRINT@357, "OPERA- 
TION: FILE CHECK *;:T1=17:S1=2:01=2: 
GOSUB 35:IFEC<>OTHEN330 
370 X1=1:FORX2=0TO77:G(X2)=PEEK 
(B+X2): IFG(X2)<>&HFFTHENX1=0 
375 NEXT:IFX1=1THENPRINT@l3,"NO 
FILES ';:GOTO390 
380 PRINT@l3,"files present "; 

385 'directory check 

390 T1=17:S1=3:01=2:GOSUB35: 
IFEC<>0 THEN 330 

395 'log check 

400 LF=1:FORX2=0TO7:IFASC(MID$ 
(LN$,X2+ 1,1)) <>PEEK(B+X2) THENLF=0 
405 NEXT:IFLF=1THENPRINT@I3+15, 
"LOG PRESENT ";ELSEPRINT@I3+1 5, 
"NO DEFECT LOG "; 
410PRINT@I1,"<C>ONTINUE <OTHER> 
ABORT TEST ";:PLAYA$ 
415 GOSUB70:IFK$='CTHEN GOSUB 
170: GOTO 425ELSECLSBC:GOTO350 

420 'log array prep 

425 IFLF=0THEN435ELSEX1=PEEK 

(B+13) 

430 X2=G(X1):G(X1)=&HB9:IFX2>=&HC0 

AND X2<=&HC9 THEN 435 ELSE IF 

X2<=77 THEN X1=X2:GOTO 430 ELSE 

PRINT@l3,"ERROR IN LOG - WILL TEST 

ALL ";:PLAYE$: LF=0: GOSUB80 

435 FORX2=0TO77: 

RP=0n-B^1=8HT<3aTOMCB^EFf^^ 

THENX1 =&HB9:GOTO440ELSEX1 =&HFF 

440G(X2)=X1:NEXT 

445 'first declare point 

450 GOSUB100:M3$="first 
":GOSUB11 0:GOSUB1 02:GOSUB 11 
455 'test sequence 



460 DATAO.38,2,0,3,39,1 ,-2,1, 3,0,0,1, 0,0, 

1,39,2,1,2,38,0,-2,0,2,1,39,2,2,3,38,0,-2,1, 

3,0,38,2,1,2,39,1,-2,2,2,0,38,2,2,3,39,1,- 

2,0,3,0,0,1,0,0,1,39,2,0,2,38,0,-2,2,2 

465 DATA0,38 t 2, 8, 3,39,1, -2,5,3,0,0,1, 0, 

0,1,39,2,5,2,38,0,-2,8,2,1,39,2,8,3,38,0,- 

2,5,3,0,38,2,5,2,39,1,-2,8,2 

470DATA17,17,1,8,3 

475'DATA0 P 3,1,0,2 

480 DATA99,0,0,0,0 

485 CLSBC:X1= 75:RESTORE:FORX= 77 

T034 STEP-1:G(X+2)=G(X): NEXT: DE=0: 

G(34)= &HFF: G(35)=&HFF 

490 IFT$="Sh'THENFORX=1TO70: 

READOP: NEXT 

495 READ TI,TE,ST,PA,OP:IFDE=1THEN 

565 ELSEIFTI=99THEN FOR X=36T079: 

G(X-2) =G(X):NEXT:GOTO 555 ELSE IF 

OP=3 THEN X= USR1(PA): GOTO 500 

ELSE IF OP=0 THEN 01=2: T1=TI: S1=1: 

GOSUB 35:GOTO 495 

500 01=OP:X1=X1+.25:PRINT@295," 

CYCLE: ";:PRINT@327," TRACK: 

";:PRINT@359," granule: "; :PRINT 

@391 ," OPERATION: ";: PRINT® 

423,STRING$(18,32); 

505 POKEPP.01 

510 FORT1=TI TO TE STEP ST:PRINT@ 

307 ,USING"#r;INT(X1);:PRINT@339, 

USING" ##";T1 ;:IFOP=2THEN PRINT @ 

403,'r*EAD "; ELSE PRINT@403,"WRITE"; 

515 FORX2=0TO1:PG=2*T1+X2 

520 G1=2*T1+X2:IFT1>17 THEN G1=G1-2 

525 IFT1=17 THEN PRINT@371, "DIR"; 

ELSE PRINT@370,USING"###*;G1; 

530 IFG(PG)=&HB9 ORG(PG)=&H99 

ORG(PG)= &HE9 THEN 545 

535 PRINT@423,STRING$(1 8 t 32);:X3=2 

56*T1+X2:EC=USR2(X3):IF EC=0THEN 

545 ELSE IF EC=2THEN X2=1:T1=TE: 

DE=1: GOTO 540 ELSE PRINT@423 f " 

BAD GRANULE ';: PLAYE$ 

540 G(PG)=&HE9 

545 NEXTX2,T1:GOT0495 

550 'final declare point 

555 GOSUB100:M3$="final ":GOSUB110: 
GOSUB102:GOSUB110 

560 'format allow table 

565 CLSBC:IFDE=1THEN330ELSEX= 

USR1(8):X3=0:X2=0:X1=0 

570 FORLG=0TO77:IFG(LG)=&H99 

ORG(LG)= &HB9 ORG(LG)=&HE9 THEN 

575 ELSE 585 

575 IFX3<>0 THEN POKEB+X1.LG ELSE 

X2=LG 

580X1=LG:X3=X3+1 

585 NEXT:IFX3=0 THEN 590 ELSE POKE 

B+X1.&HC9 

590 T1=17:S1=2;01=3:GOSUB 35:FOR 

X4=1 TO 200:NEXT:IF EC<>0 THEN 330 

595 'format dir entry. 

600X=USR1(8):FORX=0TO10:POKEB+X, 
ASC (MID$(LN$,X+1,1)):NEXT:POKEB+ 
11,1: POKEB+12,0:POKEB+13,X2:POKE 
B+14,1: POKEB+15,0: IFX3=0THEN 
POKEB.O 

605 T1=17:S1=3:01=3:GOSUB 35:FOR 
X4=1 TO 200:NEXT:IF EC<>0 THEN 330 
610 GOSUB 100:GOSUB 630:GOSUB 
102: GOSUB 630: CLSBC 



615IFP=0THEN625 

620 GOSUB225:X1=0:X2=10: X3=39: 

GOSUB 235: X1=40:X2=10:X3=77:GOSUB 

235 

625 PU\YA$:GOTO340 

630 PRINT@l3,"testcplt- FINAL DEFECT 

LIST ';:PRINT@I1 ;<OONTINUE 

"; : PLAY A$: GOSUB115:RETURN 
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FARNA Systems 

Your most complete source for Color Computer and 05-9 information! 



?o<bt Office Box 321 
Warner Kobins, GA 31099 
Phone: 912-32S-7659 

E-mail: dertfox0delphi.com 



XKOO &3 S «&/-/„ &<* GsAA*j*\£>j'\, &1 O V^A^Si 



&OOKS>: 

Mastering 06-9 - $30.00 
Update of Paul Ward's "Start 05-9" Com- 
pletely steps one through learning ail aspects 
of 05-9 on the Color Computer. Easy to fol- 
low instructions and tutorials. Conies with a 
disk full of added utilities and software! 

Tandy's Little Wonder - $25.00 

History, technical information, hacks, sche- 
matics, repairs,... almost EVERYTHING avail- 
able for the Color Computer all under one coverl 
A MUST HAVE for those wanting to keep their 
CoCo alive or for those new to the CoCo. 

Quick Reference Guides 

These handy little books contain the most 
referenced information in an easy to find for- 
mat. Small size makes them unobtrusive on 
your desk. Command syntax, error codes, sys- 
tem calls, etc. 

CoCo 05-9 Level II - $5.00 
US-9/6&000 - $7.00 

SOFTWARE: 

CoCo Family Recorder The very best in ge- 
nealogy record keeping EVER for the CoCo\ 
Requires CoCo3. two disk drives (40 track 
for OS-9) and an 80 column monitor. 
DECB: $15.00 OS-9: $20.00 



DigiTech Pro: $10.00 

Easily add eoundz to your 3ASIC and M/L 
programs) Very easy to use. Requires user to 
make a simple cable for sound input through 
a joystick port. Requires CoCoS, DECB, 512K. 

ADOS: The premiere, most respected en- 
hancement for DEC&l Support for double sided 
drives, 40/ dO tracks, faster formatting, many 
extra and enhanced commandsl 
Original {CoCo 1/2/3) - $10.00 
ADOS 3 {CoCo 3 only) - $20.00 
Extended ADOS 3 {CoCo 3 only, requires 
ADOS 3. support for 512K.-2MB, RAM drives, 
4O/&0 track drives mixed) - $30.00 
ADOS 3/EADOS 3 Combo: $40.00 

rtxel aiaster - $12.00 
High speed graphics tools for CoCo 3 OS-9 
Level 11. Easily speed up performance of your 
graphics programs! Designed especially for 
game programmmersl 

Patch OS-9 - $7.00 

The best enhancement for OS-9 short of buy- 
ing a 6309 and NitrOS9! Contains the lat- 
est version of all popular utilities and new com- 
mands with complete documentation. Has 
auto-installer (requires 2 40T DS drives, one 
may be larger). Ask for 35 track disks (manual 
Install). 



HARDWARE: 

SPECIAL PRICE ON REMAINING VIDEO DIGI- 
TIZERS: $100 (was $125) 

This may be your LAST CHANCE to get a 
DigiScan video digitizer) No MPI - uses joy- 
stick ports. CoCo Max3 , Max 10, Color Max 3 
compatible, Input from any VCR, camcorder, 
or TV camera (freeze-frame required). 

Special P 'rices on Remaining DISTO stockl 
LIMITED QUANTITIES! BUY N0W1 
Mini Controllers: Clones of the Tandy short 
disk controller, comes with DECB 2.1. NO CASE. 
$40 each 

512K Upgrades: With RAM chips: $50, with- 
out: $25 

Super Controller I : I have several boards 
that need repair. Buy two for $30 so you'll 
have extra parts, or one for $20. Comes with 
schematic. NO WARRANTY. 
HD Controller $30 - Connect embedded SCSI 
or MFM7RLL drives (with Adaptec controller) 
to your CoCo. These fit inside a Super Con- 
troller I or II. 

3 are Board Set: $30 - Set of blank circuit 
boards for Disto products including SCI, SCI1, 
HD, 4-n-1, MPROM, etc. Add $20 for com 
plete schematic set. 
Complete Dteto Schematic set: $25. 



Complete computer eyeteme baeed on the A730& board from Kreider Electronice. Systems are 
completely setup and ready to 40, just add a monitor (or we can supply that too)l 



Both systems include: 

1 6 bit PC/AT I/O bus with five slots 

MC68306 CPU at 16.67MHz 

4 30 pin SIMM sockets 

IDE Hard Drive Interface 

1 4MB Floppy Drive 

Two 1 6 byte fast serial ports (up to 1 1 5K baud) 

Bi-directional parallel printer port 

Real-time clock 

PC/AT keyboard 

Desktop Case and Power Supply 

BASIC (resembles Microsoft BASIC) 

MGR Graphical Windowing Environment 

with full documentation 
"Personal" OS-9/68000 Vr 3.0 

(Industrial with RBF) 
Drivers for Tseng W32i 

and Trident 8900 VGA cards 
Drivers for Future Domain 1680 

and Adaptec AAH1 5xx SCSI cards 

Many other utilities and tools 



FARNA-111 22 Includes: 

2MB RAM 

200MB Hard Drive* 

Trident 8900 1MB Video Card 

$960.75 



FARNA-1 1225 Includes: 

2MB RAM 

500MB Hard Drive* 

Tseng W32i 1MB Video Card 

$1114.47 



"This is the SMALLEST amount of formatted space (most manufacturers 
specify UNFORMATTED CAPACITY). Prices fluctuate - we get you the 
largest drive possible for the money allotted! 

Call for a quote on different configurations and components. Warranty is 
90 days for labor and setup, components are limited to manufacturers 
warranty. 

Microware Programmers Package - 
Licensed copies of Microware C compiler, Assembler, 

Debugger, Basic, and many other toolsl 
With system purchase: $65.00 Without system: $85.00 

More software will be listed later! 
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The Embedded Programmer 

An introduction to embedded 683xx controller tools 



It was just the other day when an engineer smiled 
and showed to rae with pride a program he had just 
written to run on MSWindows-95. The program con- 
tained many screens worth of code and all it did was to 
print the traditional "Hello World!" message on the 
screen! if this is "progress" then it is time to strip the 
software down to the bare silicon and start over. And if 
we're going to do that, let's backup one more step and 
make a better choice of silicon to begin with. 

Now-a-days this is not as bad as it seems. There are 
a wealth of tools available for those who resolve to 
master the binary world of system software. Those who 
shed the comfort of familiar desk-top operating sys- 
tems to write programs that run right on top of the hard- 
ware are called Embedded Programmers. Their prod- 
ucts are called Embedded Systems. This is a large field 
in today's market place and it only promises to get larger 
in the future. The Motorola 68K family has enjoyed 
more roles in microprocessor (mpu) based systems than 
any other, including embedded systems. That is because 
it is so flexible, easy to use, and so well supported by 
many vendors. 

Software development involves two kinds of com- 
puter systems: The Host and the Target Those who 
use MS-DOS and OS-9 are familiar with what is called 
Native Development This is when you build a pro- 
gram on the same system that you will run it on. In 
may cases, embedded systems do not have all of the 
resources that are necessary for software development 
Here you need a Host with a user interface, disk drives, 
printers, and a large amount of RAM. When the pro- 
gram is ready to run, it is "down-loaded" to the Target 
computer that it will run on. Because typical targets 
don't have user interfaces, the host often plays that role 
for testing and debugging purposes. This form of de- 
velopment is called Cross Development It allows pro- 
grammers to throw off the overhead of the host com- 
puter in their program executables without giving up 
the conveniences of their development environments. 

For several years I have been doing 68K cross de- 
velopment using the IBM-PC as my host I have used 
several different 68K designs as targets that run my 
programs. The IBM-PC is particularly good as a cross 
development host because it's OS is so primitive and 
because it is so well supported by the tool developing 
industry. Having a primitive host architecture gives you 
more freedom to write programs that simulate the 
target's behavior because it is easy to by-pass the host's 
native interfaces. But I chose the 68K as my target be- 
cause it is so much easier to design excellent software 
for anything I want to create. 68K-based hardware is 
plentiful and diverse. This great diversity has been its 
own worst enemy because it makes it hard to find one 
platform that can be considered a "standard". But pro- 
cessors of this family have even more potential than 
the popular minicomputers (such as VAXes) of the 70s 
and '80s because they are so inexpensive. All they need 
is software that is worthy of the hardware it runs on. 

In all cases, a target computer must have some way 
to communicate with the host In the simplest (and 
cheapest) case, the target will have an Erasable Pro- 
grammable Read-only Memory (or EPROM). The pro- 
cess of burning an EPROM and inserting it into the 
target's socket is rather time consuming. When you 
make changes to the software, you must remove the 
chip, erase it with an ultra-violet eraser (which takes 
around 1 5 to 40 minutes), and re-program it with the 
new version. This kind of communication tends to be 
cumbersome and begins to wear out your target's 
EPROM socket pins. A better (but more expensive) 



solution, is to use an EPROM Emulator. This is an em- 
bedded system in itself which uses RAM to mimic an 
EPROM. Your host communicates with the mpu in the 
emulator via a serial or parallel interface. It downloads 
the image data to the RAM that appears to your target 
where it expects its EPROM to be located. 

There is another method (the most expensive) of 
communication between a host and a target that uses 
an In-Circuit Emulator (or ICE). This is a device that 
replaces the target's u-processor but can do a lot more 
than the mpu can. With an ICE, your target doesn't 
even have to have any ROM because it can download 
images through the micro-processor's bus interface. 
These devices are beyond the reach of your average 
hobbyist because they are so expensive. But they can 
even assist in hardware development because they can 
inform you of the states of individual pins as well as 
read and write memory locations without having to run 
any code. 

Probably the best, and most cost effective, method 
of embedded development for the average hobbyist is 
to write some code that can eliminate the need for an 
EPROM Emulator. This is a simple program that you 
bum into an EPROM. It has to do little more that to 
accept a program downloaded via a serial port and copy 
it into RAM. If the target sees the proper format and 
detects no transmission errors, it jumps into the pro- 
gram which takes over control of the system. I have 
written such a program (I call it PREBOOT) and it 
runs on the Computer Design Services CD68X20. 
Since June of 1995, a friend of mine (who I met over 
the Internet) and I have developed a set of cross devel- 
opment tools that run on an IBM PC equiped with a 
standard VGA card. 

These tools, together with PREBOOT, make it rela- 
tively easy, and inexpensive, to write embedded code 
for 68K targets that are available off-the-shelf. 68K- 
based computers range from truely embedded systems 
such as smart multi-serial I/O cards, snarl ethemet pro- 
tocol-processing cards, laser printers, and terminal serv- 
ers to complete systems made by Hewkt-Packard, SUN, 
Apple, Atari Next, and Commodore, not to mention 
Motorola. My favorite among these "high-perfor- 
mance" systems are the VME-based systems because 
they usually come with excellent hardware documen- 
tation; something you usually don't get with worksta- 
tions. Now is a particularly good time to buy used68K- 
basedVMEeo^iprnemviau^uilernet A German sm- 
dent recently told me that companies are throwing away 
(or giving away) Motorola MVME147's. This is a 
high-integration board that uses surface-mount tech- 
nology to achieve better performance than the average 
machine you will usually see running personal OS-9. 
It has all the features you would expect of a full system 
except a user interface. I bought one brand new for 
$6,000 back in 1990 and a used one a couple months 
ago for $500. 1 hate to mention how little I paid for one 
last week! 

For the PC -compatible class, I like to use the boards 
made by Peripheral Technolc>gy/Cbmputer Design Ser- 
vices because they come with schematics and excellent 
personal support from their designer, Fred Brown. 
These boards don't have the high performance of VME 
but they have the advantage of being able to use inex- 
pensive PC hardware. The motherboard comes with 
more on-board devices than your typical Intel 
motherboard and is ready to be mounted in a PC cabi- 
net The CD68X20 is interesting in that the CPU comes 
on a daughtercard. Currently, the 68020 is the only 
CPU available but I am now talking with Fred Brown 



Paul K. McKneely 



about engineering a 68030 CPU card for the CD68X 
main board Here is a list of the CD68X20's built-in 
features: 

* 25/33 MHz 68020 /w 68882 socket 

* 2 28-pin EPROM Sockets 

* 4 Serial Ports via two MC68681 DUARTs 

* 2 Parallel Ports via MC68230 POT 

* Socket for WD33C93 SCSI Interface 

* IDE Drive Interface 
*6 16-bit ISA Slots 

* MK48T02 2K BBRAM Clock/Calender 

* 8 30-pin SIM Sockets (up to 128 MB) 

* 8-bit A/D Speaker Interface 

* IBM-PC/XT Keyboard Interface 

Although 1 have been using this computer as an 
embedded programming target computer, it is capable 
of being the heart of a very powerful computer system. 
For those of you who desire to get down to the bare 
silicon, it is an excellent vehicle to learn on I have three 
CD68X20's and I have been using them to ^^velop a 
Kernel for embedded, real time, and general purpose 
use. The key to building a good operating system is in 
solving the problem of making a single processor to be 
able to handle many things well in parallel. There is a 
clever technique for doing this efficiently by making 
effective use of the 68Ks interrupt structure but the 
way I did it requires some minor board modifications. 
These board modifications will not interfere with OS- 
9 for those of you who would like to keep their options 
open for that operating system which can be purchase 
from CDS. 

I hope a few of you are guessing at where we are 
headed with this. In future articles I would like to dem- 
onstrate the use of the tools that David and I have writ- 
ten. I will discuss the 68K's interrupt structure in de- 
tail and explain its boot up process. This will prepare 
us to explore the fundamentals of how to write a high 
performance "micro-kernel" and how standalone em- 
bedded programs can be written using these tools along 
with the PREBOOT program I will explain the board 
modifications that are necessary to run the PhiKemel 
and why they are necessary. Soon you will be off and 
running, writing your own standalone "embedded" pro- 
grams. But don't let me fool you. Where I intend to 
eventually lead you is to a new operating system that I 
have been developing for several years, PhiOS (pro- 
nounced fi-oh-ess). It should be a fun experience. Those 
of you who really want to know how high performance 
computer systems work, come with me. We're in for a 
great adventure! 

For those of you who would like to follow along in 
this series of articles titled "The Embedded Program- 
mer", you can obtain a CD68X20 from its designer 
Fred Brown at: 

Computer Design Services 

1250 Piedmont Rd. 

Marietta, Ga. 30062 

Voice: (770) 973-2156 

FAX: (770) 973-2170 

Those of you who would like to respond to me di- 
rectly about the contents of this article can reach me at: 

techno Venture, Inc. 

P.O. Box 5641 

Pasadena, Texas 77508 

E-Mail: gecko@onramp.net 
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Operating System [line 

Install Multi-Vue on your hard drive! 



Chris Burke 



Before we start, you need to know what my system 
looks like: 

CoCo3,512K 

Hi-Res Mouse 

20 Meg Hard disk (set up as "/d0") 

35 Track floppy (set up as "/dl") 

Parallel printer (set up as "/pi") 

Tandy ACIAPAK (set up as *7t2") 

WIZ ACIA driver (set up as fc Vm2w") 

Magna vox (RGB) monitor 

The first thing you should do is read the "Getting 
Started" section of the manual. Then read pages 9-28 
through 9-3 1 , which give you the format of MV's "en- 
vironment file". The environment file configures MV 
to your system, and you will have to modify h in order 
to successfully install Multi-Vue. 

Now, make a backup of the release disk(s). Tandy 
has distributed Multi-Vue on 2 sides of a single floppy 
disk, so you need to back up each side to a seperate 
"normal" floppy disk. Label the backups DISK # 1 and 
DISK#2. Put the master in a safe place, and use ONLY 
the 2 backups for the rest of this procedure. 

Here we go: 

1 ) Make sure that all of the files from your LeveL2 
OS-9 release and CONFIG disks are on the hard drive. 
If they are not, you can put the OS-9 release disk in /d 1 
and enter: 

OS9:chd/dl 

OS9:dsave -s20 /dl /dO ! shell 
Then put the CONFIG disk in /dl and enter 

OS9:chd/dl 

OS9:dsave -s20 /dl /dO ! shell 
This takes a while, but does the trick Remember, /dO 
is the hard drive in the above example! If your hard 
drive has a different name, don't forget to change when 
typing. 

2) Put DISK #2 in /dl, and copy everything from it 
to your hard drive: 

OS9:chd/dl 
OS9:dsave-s20/dl /dO ! shell 

3) Unless you want Multi-Vue to boot automati- 
cally, you must delete the AUTO EX file from your hard 
drive: 

OS9:del /dO/cmds/autoex 
It seems that this is one Tandy didn't tell us about Any 
file named /dO/cmds/autoex will boot automatically 
whenever OS-9 is started. 

4) Put DISK #1 in /d Land copy the contents of its 
CMDS directory to the hard disk: 

OS9:chd/dl/cmds 

OS9:dsave -s20 /dl /dO/cmds I shell 

5) Copy the environment file from DISK #1 to the 
hard drive: 

OS9:copy /dl/sys/env.file /dO/sys/env.file 



6) Edit the environment file to tailor it to your sys- 
tem. I had to change the following entries: 

OLD FIELD NEW FIELD Description 
MONTYPE=0 MONTYPE-1 Select RGB monitor 
RAM=128 'RAM-128 Comment out 128K 

code 
*RAM=512 RAM=512 Use 512K code 

PTRRES-0 PTRRES= 1 Hi-Res mouse 
RBFDEV= RBFDEV= Register all RBF devices 
/dOydl /d(Vdl, 
/d2;d3, 
/hUdd 
SCFDEV= SCFDE V= Register aU SCF devices 
/pytl /piyt2, 

/m2w 
PRPORT=/p PRPORT=/pl Use my printer driver 

7) Add the following line to your startup file: 
merge /dO/sys/stdfonts /d0/sys/stdpnts_4 /do/sys/ 



8) Build a short -xnnmand file to start Multi-Vue: 
OS9:build /dO/xmv 

tmode-echo 

control -e 

gshell& 

tmode . 1 echo 

The CONTROL program uses the environment file 
to set up some of Multi-Vue 's parameters, etc. GSHELL 
is the new graphic shell that is supplied with Mutti- 
Vue; it will automatically create a graphics window 
for itself any time you run it 

9) Make anew OS9boot disk that supports Multi- 
Vue. This will be identical to your existing boot file, 
with the following exceptions: 

i) Use WINDINT.IO instead of GRFINT.IO 

ii) Include W7.WD through W12.WD, to provide 
additional windows. NOTE: if you have 512K, you 
can also include W13.DD, W14.DD, and W15.DD 

In this case, the easiest way to make a new boot disk 
is to use OS9GEN. If you have added anything to the 
standard Tandy boot, you probably already have a 
BOOTUST file around somewhere— just add the new 
modules to it For the standard Tandy boot, you can 
use the file 'VdO/modules/bootlistmv J \ In any case, you 
must put a new disk in /dl and enter: 

OS9:format/dlr"" 

OS9:os9gen/dl #40K </dO/modules/bootlistmv 

10) Users of XT-ROM may wish to install the new 
boot file on the hard disk To do this, enter 

OS9:bootport/dl/dO 

11) Take a break. After all this you deserve it Of 
course, you've come this far, so . . . 

12) Boot the new system, either from the hard disk 
or the floppy disk. 

13) THIS IS IT! Run Mufti- Vue by entering: 



OS9:xmv 

Now hit the CLEAR key until you end up in th 
Multi-Vue GSHELL window. 

14) Each time you execute the XMV file, another 
Multi-Vue graphic shell will be spawned. You can ro- 
tate between all of your spawned SHELL and GSHELL 
windows by depressing the CLEAR key. 

A Brief Review of Multi-View 

Summary: I give it a 5 (out of a possible 10). Im- 
pressive, as long as you didn't expect a Macintosh 
(which I did , , .). The screens and icons look great I 
wish that you could have MV come up in HI RES screen 
mode. As it is, you have to bring it up in LO RES and 
change over. Mouse operation is very smooth, and the 
default mouse speed is very comfortable (hi -res 
mouse).The documentation looks very good. There is 
an extensive section on accessing the windows from 
"C". You cannot drag icons around on the screen, and 
there is no TRASH icon (Apple computer has a copy- 
right on the trash can anyway). All file manipulation 
is done by typing in file names from the keyboard. You 
cannot "double click" to execute an application. 

There is no good way to open multiple directories 
on the desktop. You can only have one directory open 
at a time. Of course, since you can't Hrag icons around, 
much of the reasoning behind having multiple directo- 
ries open does not apply. 

GSHELL is written in "C", and it takes up about 
16K (without any merged utilities). The standard OS- 
9 shell is written in assembler and uses about 1.5 K. 
This is a very big difference, and means you may not 
be able to run big applications (like the "C" compiler' 
from within GSHELL. 

Several nifty "pop-up" utilities are provided with 
Multi-Vue. These include a clock, a calendar, a deci- 
mal and HEX calculator, and a method for escaping to 
the standard OS-9 shell The clock utility draws an ana- 
log clock face on the screen and updates it in real time! 
The clock face is oblong, rather than round, and the 
proportions of the hands make the clock difficult to read 
— especially in HI RES mode. 

The calculator is very handy, especailly the HEX 
feature (for programmers like me). The screen defini- 
tions of the key boundaries are off a little bit; for ex- 
ample, the **=" key often registers as "3". Also, you 
must press the keys with the mouse kind of sloooowly 
if you want them all to register. 



Don t worry ! 

Rick Ulland will return with 

his usual hints, tips, and wit 

in the next issue! 



Atlanta Computer Society's Picnic In The Park 
Stone Motmtain Park, GA! 

Rather than having a regular CoCoFest this year, ACS has decided to have a picnic 
at Stone Mounatian Park, just east of Atlanta. It will be held on October 5th, 1996. 

I will have more information in the next issue. For those requiring more info sooner, 

please contact ACS at: P.O. Box 80694, Atlanta, GA 30366; BBS 404-636-2991. 

You may also contact Frank Swygert via E-mail: dsrtfox@delphi.com 
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Color Computer Disk Drives 

Mixing and matching disk drives for the Color Computer 



Frank Swygert 



I've had several inquiries on disk drives for 
the Color Computer... enough to warrant writ- 
ing this article. The questions are a good sign, 
actually. They indicate that there are still a few 
beginners out there trying to learn more about 
their systems... and trying to keep them run- 
ning a while longer. I'll cover enough to make 
this interesting reading even for the more sea- 
soned CoCo veterans, so don't turn the page 
just yet! 

Disk Basics 

The very first storage media for "personal" 
computers was punched paper tape. This was 
just what it sounds like... a strip of approxi- 
mately one inch wide paper with a series of 
holes punched across it. The holes translated 
into characters on the screen or in memory. The 
reason this was used was because it was cheap. 
There were disk drives available at the time, 
but they were "hard drives" and very expen- 
sive... try over $10,000 for a 5MB or so drive 
(these were used for mainframes). For those 
who have seen them, the paper tape was the 
same as used with Teletype machines. That's 
why they were so cheap at the time. 

It didn't take long for computer hobbyists to 
adapt the audio cassette recoder for data stor- 
age use. Here was a common, inexpensive for- 
mat. The problems were that it wasn't random 
access, there were no standards, and reliabil- 
ity wasn't the best with most systems. 

Then IBM introduced the "mini-floppy" 
drive. This started out as an eight inch disk, 
but eventually got down to the current three- 
and-a-half inch variety. The "mini-floppy" be- 
came popular with business computers, and 
was soon introduced in prices that hobbyists 
could afford. Nowadays, a floppy drive is es- 
sential. Prices have come down to the point 
that there is no real reason for any computer, 
even the "classics" that are hanging on like 
the CoCo, to not have a Qoppy attached. 

Let's take a look at what floppy disks have 
in common first. The least common denomi- 
nator is the media itself The media that is ac- 
tually written to is a paper thin piece of plastic 
(usually mylar) with a magnetic coating. This 
is encased in either a flexible (5.25" disks) or 
hard (3.5" disks) plastic protective covering. 
This covering protects media from scratches 
and dust. 3.5" drives have a little metal shield 
that slides over the media access opening. 5.25" 
disks lack this cover and must be placed in 
"jackets". 

The media coating is different depending on 
the density of the disk. "Density" refers not 
only to the number of tracks on a disk, but to 
the amount of data that can be stored on a track. 
There are basically two track densities. 360K 
and under disks usually have 48 tracks per inch 
and 256 bytes per sector. These are referred to 



as "double density" disks (the first disk dnves 
only stored 128 bytes per sector). 720K and 
greater disks have 96 tracks per inch. 720K 
disks are double density, but the higher capac- 
ity 1 4M disks are called "high density" in- 
stead of "quad density", which at first glance 
would seem to make more sense (they store 
512 bytes per sector, and the latest 2.8M disks 
1024 bytes per sector). Only 40 (360K) and 80 
(720K and up) tracks are actually used on the 
floppy disk. A more sensitive coating is used 
on the high density (1.2M 5.25" and 1.4M and 
2.8M 3.5") media. The high density media is 
so sensitive that if it is formatted using a low 
density drive, it will no longer format at high 
density, and may not be reliable at low density 
either. In other words, the disk is ruined. While 
many people punch holes in the 3.5" double 
density disks and format them for high density 
use, this is not recommended. Information on 
such a disk will gradually "disappear", as the 
magnetic coating isn't sensitive enough to hold 
the data for long periods. Note that the 2.8M 
drives use the same high density disks as 1 .4M 
drives. 

Another drive identifier is the height of the 
drive unit face. A "full height" 5.25" drive is 
approximately three inches tail, measured at a 
right angle to the disk slot. "Half height" drives 
are therefore approximately 1.5" tall. 3.5" 
drives are designated a little differently, since 
there never was a "full height" model. When 
first introduced the 3.5" drive was approxi- 
mately 1.25" tall, but the newer models are 
only 1". 

When speaking of older drives, there is an- 
other item to consider — the number of "sides". 
A single sided drive reads only the "bottom" 
side of a disk. A double sided drive naturally 
has a read/write head on each side. In the early 
days, single sided drives were cheaper and 
easier to build. Even IBM used a 35 track single 
sided drive in their first PC. Many early com- 
puter users maximized their disk use by buy- 
ing or making "flippy" disks. These had a sec- 
ond timing hole and side notch that allowed 
one to literally "flip" the disk over and 
record information on the "back" side. 
CoCo owners used this method often. 

I realize that the above explanation 
is simple, but the reason for this ar- 
ticle isn't to explain all about disk 
drives. The preceding was just to give 
a little background information. 

Tandy Color Computer Disk Drives. 

Tandy first introduced disk drives 
for the CoCo in November of 1981. 
This was a double density single sided 
full-height 35 track 5.25" drive with a 
six inch long controller and a flat rib- 
bon cable (catalog number 26-3022). 



Floppy drives were just starting to come into 
widespread use at this time, and some of the 
older systems used these 35 track drives. This 
included Tandy's TRS-80 line. Naturally, these 
drives and enclosures were the same as the 
TRS-80 Model 1 and Model 3 units. These 
systems retailed for $499.95. These early 
model controllers required 12 volts to operate. 
The only reason one would be desired now is 
that they can be modified to support high den- 
sity drives. As they are, they only support 
double density (up to 720K). 

In 1983 Tandy upgraded the disk system with 
a new five volt only controller. The new con- 
troller was necessary since the then new CoCo 
2 didn't provide 12 volts on the cartridge port. 
To use the old controller with the new com- 
puter either a Multi-Pak Interface (MPI) was 
required or 12 volts had to be supplied. Many 
users simply borrowed 12 volts from their disk 
drive power supply and ran it back to the con- 
troller. This was called the FD-500 system, 
catalog number 26-3129. 

Tandy upgraded the disk system again in 
1986, this time with a more compact five volt 
controller and a 40 track single sided drive (FD- 
50 1 , catalog number 26-3 131). This was mostly 
due to the fact that 35 track drives had been 
phased out by the manufacturers. Tandy could 
actually buy the 40 track drives for less than 
35 track models. Note that Tandy never up- 
graded the Disk BASIC ROM code to access 
the additional storage capacity. One modified 
the ROM code, bought a third party extension 
(such as ADOS), or used OS-9 to use the addi- 
tional drive capacity. The standard for the CoCo 
was 35 tracks throughout its lifetime. 

With the advent of the CoCo 3, Tandy again 
upgraded the drive system (FD-502, catalog 
number 26-3133). This time double sided 40 
track drives were used. OS-9 was growing in 
popularity amongst CoCo users and really 
needed the extra disk capacity. In order to fos- 
ter a growth in OS-9, Tandy announced that 
they would only be interested in marketing 
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28456 S.R. 2, New Carlisle, IN 46552 

219-654-7080 eves & ends MO, Check, COD; US Fluids 

Shipping included for US, Canada, & Mexico 

MM/1 Products (OS-9/68000) 

CDF $50.00 - CD-ROM File Manager! Unlock a wealth of files on CD with the MM/1 ! Read most text and 
some graphics from MS-DOS type CDs. 

VCDP $50.00 - New Virtual CD Player allows you to play audio CDs on your MM/1 ! Graphical interface 
emulates a physical CD player. Requires SCSI interface and NEC CD-ROM drive. 

KLOCK $20.00 - Optional Cuckoo on the hour and half hour! ! Continuosly displays the digital time and 
date on the /term screen or on all open screens. Requires I/O board, I/O cable, audio cable, and speakers. 

WAVES vr 1.5 $30.00 - Now supports 8S VX and WAV files. Allows you to save and play all or any part of 
a sound file. Merge files or split into pieces. Record, edit, and save files; change playback/record speed 
Convert mono to stereo and vice-versa! Record and play requires I/O board, cable, and audio equipment 

MM/1 SOUND CABLE $10.00 - Connects MM/ 1 sourcl port to stereo equipment for recording and palyback. 

GNOP $5.00 - Award winning version of PONG(tm) exclusively for the MM/ 1 . You'll fo crazytrying to beat 
the clock and keep that (£}#$%& ball in line! Professional pongists everywhere swear by (at) it! Requires 
MM/1, mouse, and lots of patience. 

CoCo Products (DECB) 

HOME CONTROL $20.00 - Put your old TRS-80 Color Computer Plug n' Power controllc. back on the 
job with your CoCo3 ! Control up to 256 modules, 99 events! Compatible with X-10 modules. 

HI & LO RES JOYSTICK ADAPTER $27.00 - Tandy Hi-Res adapter or no adapter at the flick of a 
switch! No more plug and unplugging of the joystick! 

KEYBOARD CABLE $25.00 - Five foot extender cable for CoCo 2 and 3. Custom lengths available. 

MYDOS $15.00 - Customizable, EPROMable DECB enhancement The commands and options Tandy left 
out! Supports double sided and 40 uack drives, 6ms disk access, set CMP or RGB palettes on power-up, 
come up in any screen size, Speech and Sound Cartridge support, point and click mouse directory, and MORE 
OPTIONS than you can shake a stick at! Requires CoCo3 and DECB 2. 1 . 

DOMINATION $18.00 • Mutti-Pl&yer strategy game. Battle other players armies to take control of the 
planet Play on a hi-res map. Become a Planet-Lord today! Requires CoCo3, disk drive, and joystick or 
mouse. 
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SMALL GRAFX ETC. 

"Y" and "TRT cables. Special 40 pin male/female end connectors, 

priced EACH CONNECTOR - $6.50 

Rainbow 40 wire ribbon cable, per foot - $ 1.00 

Hitachi 63C09E CPU and socket - $13.00 

5 12K Upgrades, with RAM chips - $72.00 
MPI Upgrades 

For all large MPIs (PAL chip) - $ 10.00 

For all small MPIs (satellite board) - $ 10.00 

Serial to Parallel Convenor with 64K buffer, cables, 

and external power supply - $50.00 

2400 baud Hayes compatible external modems - $40.00 

ADD $2.00 S&H TO EACH ORDER 



SERVICE, PARTS, & HARD TO FIND SOFTWARE WITH COMPLETE 
DOCUMENTATION AVAILABLE. INKS & REFILL KITS FOR CGP-220, 
CANON, & HP INK JET PRINTERS, RIBBONS & vr. 6 EPROM FOR CGP- 
220 PRINTER (BOLD MODE), CUSTOM COLOR PRINTING. 

Terry Lara way 

41 N.W. Doncee Drive 

Bremerton, WA 98311 

206-692-5374 
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The BlackHawk MM/lb 

Based on the AT306 board from 
Kreider Electronics. Features buii 
into the motherboard include: 

1 6 bit PC/AT I/O bus with five slots 
MC68306 CPU at 16.67MHz 
512K to 16MB of RAM with 

30 pin SIMMs (4 sockets) 
IDE Hard Drive Interface (2 drives) 
360K-1 .44MB Floppy Drive 

Interface (2 drives) 
Two 16 byte fast serial ports 

(up to 115Kbaud) 
Bi-directional parallel printer port 
Real-time clock 
PC/AT keyboard interface 
Standard PC/AT power connector 
Baby AT size - fits standard PC case 
BASIC (resembles Microsoft 

BASIC) 
MGR Graphical Windowing Envi- 
ronment with full documentation 
"Personal" OS-9/68000 Vr 3.0 

(Industrial with RBF) 
Drivers for Tseng W32i and 

Trident 8900 VGA cards 
Drivers for Future Domain 1 680 and 

Adaptec AAH15xx SCSI cards 
OS-9/68000 Vr 2.4 with Microware 
C 3.2, Assembler, MW Basic (like 
Basic09), MW Debug, MW Pro- 
grammers Toolkit 
UUCP from Bon Billson 
Ghostscript (software PostScript 

interpreter) 
Many other utilities and tools 

Prices start at $400! 

(motherboard, 

Personal OSK, & MGR only) 




BlackHawk 
Enterprises, Inc. 

;756 Gause Blvd. #29 
Slidell, LA 70458 
E-mail: nimitz@delphi.com 
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CoCo 3 software if it were written tor OS- 9. 
Unfortunately, this was a little to late in the 
game ot have any impact on sales. 

Note that Tandy used basically standard, 
readily available drives. Other manufacturers 
(especially Apple, Atari, and Commodore) 
used modified electronics in their systems. This 
means that upgrading the CoCo drive system 
is relatively inexpensive, since the IBM/PC 
clones use the same drives. 

Upgrading CoCo Drives 

If you are still using full height drives, please 
consider upgrading! The old full height units 
are slow and eat up a lot more power than 
newer half height drives. Double sided 40 track 
(360K) can be purchased new for as little as 
$10-$ 15. All one has to do is remove the old 
drive and plug in a new one. While you're at 
it, go ahead and plug in two. The second drive 
is really worth the money and backups will go 
mud. faster. Two drives are really a necessity 
when working with OS-9. 

Note that all CoCo drive controllers can sup- 
port up to 720K drives, whether they are 5.25" 
or 3.5". At one time the 5.25" 720K drives were 
very popular with OS-9 users. They were 
cheaper than the 3.5" models and could be 
"double stepped" (head moved two tracks at a 
time) to read (but not reliably write) 360K 
disks. While many of these are still in use, they 
are not recommended as upgrades now. The 
3.5" 720K drives are getting hard to find also, 
but that isn't as much of a problem as it may 
seem. Most of the newer 3.5" 1 .4M drives can 
be set to operate as a 720K drive. Check with 
dealers or manufacturers before buying to make 
sure. This is necessary since 1 ,4M drives spin 
faster than 720K drives. Some drives have a 
jumper to force them to always operate at the 
slower speed. With OS-9, you need all the stor- 
age capacity you can get, so the 3.5" 720K 
drives make a lot of sense! They run $25-530 
new. It is a good idea, however, to ALWAYS 
have at least one 5.25" 360K drive in the sys- 
tem. Single or double sided disks can be for- 
matted, copied to, and read, making it easier 
to swap files and disks with otheT users. 

The old full height drive cases have plenty 
power to operate two floppy drives easily, es- 
pecially the cases with the transformer hang- 
ing outside the back of the case. The FD-502 
power supply is a little weak, so be careful 
with it. Tandy even supplied a small fan with 
the Drive 1 kit, so a fan is definatcly recom- 
mended. A small 2" fan can be purchased from 
any electronics store and added inside the drive 
case. It may take some ingenuity to mount, but 
that double sided picture hanging (foam core) 
tape sure comes in handy... 

Another problem one may run into is the 
power connector. 3.5" drives use a different 
power connector than the standard 5.25" drives. 
An adapter can be purchased from most com- 
puter stores (including Radio Shack) and 
plugged between the drives. Many users sim- 



ply snip the old connector off and solder on a 
new one of the correct type or add another set 
of leads and a connector. 

The drive cable itself needs to be looked at. 
Older drives use a flat ribbon cable. Take a 
close look at the connectors. Tandy's first drive 
systems had all the drive selects jumpered on 
the drives. A drive knew which number it was 
by the position on the cable — the ^eeth" in 
the cable that selected drives were missing 
except the one for the appointed number. If 
your cable has connectors with missing teeth 
you can get new connectors from Radio Shack 
and enmp mem an inch or so away from the 
original connectors. Then use the drive select 
jumpers to designate which drive is which. The 
jumpers are located near the connector on the 
drive circuit board. They will be labeled "DSO" 
through "DS3", designating drive 0, 1,2, or 3. 
Place the jumper over the numbers you wish 
the drive to be. Some drives may use letters 
instead of numbers (A-D), and some newer 
ones will only have two selects. If there are 
other jumpers nearby, don't move them. 

If you find that you have a cable with a few 
wires twisted, you have an IBM type cable. 
IBM ships their systems with both drives (if 
there are two floppies) jumpered as drive one 
(or A). The twist in the cable moves the drive 
zero select line to the drive one line. The drive 
on the end of a twisted cable is always drive 
zero (A), and the one on the center connector 
one (B). This was supposed to make it easier 
to install the second drive later... no jumpers 
to fool with! Most CoCo systems used a flat 
cable, but this is good information if you buy a 
new cable through a PC dealer or find a sys- 
tem set up this way. 

The FD-502 used a round cable between the 
drives and controller. This is basically a flat 
ribbon cable rolled into a plastic jacket. This 
was done because the FCC regulation govern- 
ing radio emissions from electronic equipment 
was made more stringent. There is some extra 
shielding inside that plastic jacket also. Tandy 
left just enough room between the two drive 
connectors to connect one drive directly under 
the other. Since there has never been a stan- 
dard location for the connector on the drive 
(except at the back!), this can pose a problem. 
The solution is very simple. Cut the wire tye 
holding the cable to the case. Then carefully 
slit the cable jacket. There is a flat section of 
cable every few inches where a new connector 
can be crimped on. If this sounds like to much, 
get a flat cable made or get a cable from any 
PC dealer and install as previously mentioned. 
Disk drive connectors are pretty standard. 
Cables are usually marked with one wire col- 
ored or striped. This wire should be connected 
to pin one of the connectors. The pin numbers 
are marked on the drive circuit board, so make 
sure pin one is on the correct side of the cable. 
If by chance you connect one (or both) of the 
drives wrong, don't panic. The lights and mo- 
tors of both drives will come on, but no harm 



is done. Find the connector that is backwards 
and flip it over. Note that 5.25" drives use an 
edge card connector but 3.5" drives use a ptn 
connector. The connectors are readily available 
at Radio Shack, so if you plan on using a 3.5" 
drive on your existing cable get one and enmp 
it on. Alternately, PC cables usually have both 
types of connectors, so you may want to get a 
PC cable. Some PC controllers use a pin type 
connector on the controller end, the CoCo re- 
quires an edge card connector. Make note of 
this when purchasing a cable from a PC dealer! 
A mounting adapter can be readily purchased 
to put the 3.5" drive in a 5.25" opening. Make 
sure you get the faceplate with it, or be pre- 
pared to make a filler plate from cardboard. 
Most adapters available now are made for 3 5" 
hard drives and don't come with the filler/ face 
plate. Some of the old full height drive cases 
won't be drilled to mount more than one drive, 
so some drilling may be required. If the sides 
of the case don't extend far enough to mount a 
second drive, drill a plate to mount one drive 
on top of the other, using the side mounting 
screw holes to secure the drives together. 

OS-9/68000 Machines 

Like the newer Windows based machines, 
OS-9/68K machines have adopted the 3.5" 
1 4M drive as standard. Unless there is a need 
to read files from a CoCo with only a 5.25" 
drive, there is no real need for a 5.25" drive. 
The FHL KiX and other Hazelwood based 
machines have controllers that support 2.SM 
drives. Machines that use standard PC type 
controllers are capable of using 2.8M drives 
provided the controller and drivers support this 
format. The 2.8M drives never have really 
caught on. The reasoning is simple: almost all 
modern computers (and I can't think of a single 
exception) use hard drives, and most also have 
CD-ROM drives. The only real purpose for a 
high capacity floppy is to backup the hard drive 
or maybe distribute software. Tape backup sys- 
tems are much more efficient than using flop- 
pies for backup, and large programs are more 
likely to be distributed on CD-ROMs than on 
floppies. 

The days of the floppy only system is pretty 
much over. There are a few of the older sys- 
tems, such as the CoCo, that will perform rea- 
sonably well with just floppies, but any up-to- 
date system requires over 4MB or RAM, 
100MB of hard drive space, a CD-ROM, and 
a high resolution monitor. And that is just a 
very basic system! Progress... where is it tak- 
ing us? We used to be able to do so much with 
less... at least the costs are still on par! (A ba- 
sic CoCo floppy system costs nearly $1000 
when first introduce... computer, drives, and 
all... a basic 486 or AT306 system costs about 
the same today). 
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Basic09 In Easy Steps 

Windows... can't live with them, can't live without them! 



Chris Dekker 



... Of course this has been said about many 
entities (dead or alive) throughout history. My 
guess is that we could live without them if 
we had to, but our programs would look no- 
where near as impressive. There are more 
legitimate reasons for using windows. Desk- 
top packages, for instance, or GUI's (graphi- 
cal user interfaces) would leave you with a 
cluttered (and mostly useless) screen in no 
time if they couldn't use windows. 

Another very important reason shows up 
with multitasking operating systems like 
OS9. We want to have a series of windows 
into the computer so we can actually see what 
the various programs are doing. If OS9 had 
no windows you could always launch 3 or 4 
background tasks and hope that none of them 
ever encountered an error. If they did, your 
means of communications would be limited 
to an occasional beep or a messed up screen. 

So let's cherish our windows! But how do 
they work? On the surface it is easy enough: 
RUN gMO'dwset",...) will get you a win- 
dow to work with. Howevei to make the most 
of them, you need to have some understand- 
ing of what's actually going orr. In this ar- 
ticle I will try to get you underway. 

Under OS9 the windows system is a part 
of the operating system. It consists of the 
Grfint module (Windlnt for MultiVue, which 
includes all the code of Grfint) and a subrou- 
tine package in the GrfDrv file. This pack- 
age contains the actual code for functions like 
handling windows and graphics buffers or 
drawing letters or arcs on the screen. 

The code in Grfint checks and sets up vari- 
ables for the various functions. It also con- 
tains a number of system calls like the code 
that returns screen size, type, colors, etc. The 
extra code m Windlnt mostly deals with 
what's called the high level window handler. 
This code sets up and updates menubars, 
scrollbars and a window's borders and con- 
trol regions. 

What you won't find here is the code that 
handles your mouse. Although a mouse is 
usually associated with a windows environ- 
ment, it is an input device and handled by 
the CC3IO module. Similarly, AIF's and 
icons (under MultiVue) are not part of the 
windows system but are handled by GShell. 
According to OS9, this is simply another 
application. 

I am making these distinctions to show 
that, even if you have only "plain vanilla" 
OS9 and Basic09, you can write programs 
that make full use of the windows. It just 
takes a little ingenuity and some extra work. 
For instance: MultiVue 's icons are 24x24 



pixel GET/PUT buffers. You can put them 
on the screen just as easy from a Basic09 pro- 
gram as from within GShell. 

Another avenue would be to create or use 
a subroutine package to draw borders on the 
windows. A public domain package called 
Gfx5, written by Floyd Resler, does an ex- 
cellent job in this respect. It also handles 
menubars, scrollbars and pulldown menus 
with simple RUN statements. 

The only drawback on the CoCo is that you 
have to use the graphics screens to make your 
setup visually appealing, but this slows 
things down quite a bit. Fortunately the 6309 
processor can overcome these problems. You 
will need a set of screen drivers specifically 
written for the 6309, but it can handle win- 
dows as if you had a coprocessor installed. 

OS9 recognizes 2 types of windows: de- 
vice windows and overlay windows. A de- 
vice window is the window we use to run 
programs in; most of the time anyway If you 
boot up using the TERM_WIN descriptor, 
you will be looking at a device window when 
the green 32x16 screen disappears. This de- 
vice window is called Term. Other device 
windows are called w, wl , w2, etc. OS9 can 
handle up to 16 of these device windows (as- 
suming you have enough memory available) 
and up to 32 windows in total. This total 
counts both device and overlay windows. 

So what does a window look like to OS9? 
To the core operating system it is just another 
device, like a disk drive, a printer or a mo- 
dem. On the other hand you could call a win- 
dow a virtual device in the sense that it ex- 
ists only in cyberspace and vanishes the mo- 
ment you turn off your CoCo. From this point 
of view a window is only a chunk of memory, 
connected with a couple of smaller chunks 
of memory that hold it's vital parameters. 

The reason we can see a window is that 
some of these parameters get jammed into 
the GIME's registers. This causes the hard- 
ware to present us with with a certain inter- 
pretation of the data in a memory block. If 
we are lucky this data will make sense to us 
and we call it a window; if we can't make 
sense of it, we generally call it a crash! 

The smaller chunks of code mentioned 
above are part of the internal data structures 
set up by OS9 to keep it's house in order. 
One of them is called the "window table". 
You may have come across this name in the 
error messages. 

The window table is a 512 byte block of 
memory in (MMU) block (at least on a 
CoCo). For the curious: it starts at offset 
S1A80. This block is divided into 16 32-byte 



blocks. Each block is associated with a d ; 
ferent device window. It contains the 
window's type, memory block, starting ad- 
dress and fore/background and border col- 
ors, as well as a window's current palette. 
Every time you push the clear key (to switch 
windows) most of this information is writ- 
ten into the GIME's color and DAT regis- 
ters, so you will see the window you expect 
in it's own colors. 

Note mat if you use the command RUN 
gfx2(" palette",...); you change a byte value 
somewhere in this window table. Using the 
"defpalette" command changes a byte in a 
different memory block. This block is also 
situated in block (offset $ 1 0C7), but resides 
outside the windowtable. 

Each window has also a different block of 
data associated with it. I don't know what 
it's official name is, but analogous to OS9's 
path descriptors and process descriptors we'll 
call it a windowdescriptor. (Note that this is 
not the same as the device descriptor for a 
window which is loaded with the bootfile.) 

Window descriptors are 64 bytes long. 
OS9 (during boot up) reserves space for a 
list of 32 descriptors; starting at offset $1280 
in block 0. The parameters in this block r 
ally define the window and what's on i 
Among them you'll find the window's size 
and working area, cursor position, screen at- 
tributes and flags. You will also find links to 
graphics, font, pattern and gfx cursor buff- 
ers, and to saved overlay windows so the 
original screen can be restored if the overlay 
window closes. 

Apart from that the block holds more ar- 
cane data like register masks, scale factors, 
jump addresses, etc. As you can see, it takes 
a lot of parameters to define a virtual device. 
You see, the computer addresses screen 
memory as a long string: it really has no clue 
where one line ends and the next one starts 
unless you give it some pointers and starting 
addresses. Communicating with a printer, for 
instance, is much easier because all those 
tasks are taken over by the printer's own mi- 
croprocessor and associated hardware. 

Unlike the window table which contains 
only entries for DEVICE windows; window 
descriptors are also initiated if you open over- 
lay windows. Every time you open an over- 
lay window it gets linked to the underlying 
window by a pointer. If this pointer (at offset 
2 in a descriptor) reads $FF it means you ? 
looking at a device window: the bottom 
the stack. 

For those of you who have gotten really 
curious what these things look like in real 
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life, I have included the following program. 
It gives you a hexdump of block 0. 1 admit it 
is somewhat crude, but., nobody is going to 
stop you from experimenting your way to a 
more useful program. You can add some code 
to dump modules (a FSLink system call) or 
files. 



PROCEDURE dump 
TYPE registers=cc,a,b,dp:BYTE; x ,y,u: 
INTEGER 
DIM regs:registers 
DIM i T pointer,blockend: INTEGER 
DIM paus,options(32):BYTE 
regs.a=l \regs.b=$26 
RUN syscall($8D jegs) \(* get screen size 
IF regs.x<80 THEN 
RUN grx2("dwencT) 
RUN gft2("dwset",2,0,0,80,24, 1,0,0) 
RUN grx2("select") 
RUN gfx2Cpalette",0,0) 
\(* black background 

RUN grx2("palette",9,63) 
\(* white lexers 

EMDIF 
\(* now we have an 80 column window 
regs.b=0 \regs.x=ADDR(options) 
RUN syscall($8D,regs) 
\(* get window parameters 

paus=options(8) 
\(* preserve current status 
options(8)=l 
RUN syscall($8E,regs) 
\(* force end of page pause 
regs.xKlNregs.b^l 
RUN syscall($4F,regs) 
\(* map block 

IF LAND(regs.cc,l)=l THEN ERROR 
regs.b\ENDIF 
pointer=regs.u \blockend=pointer+8192 
WHILE pouiter<blockend DO 
PRINT USING "x2>T;pointer-regs.u; 
FORi=0TO15 

PRINT USING 
"x 1 ai2"^EEK(pointer+i); 
NEXT i \ PRINT 
pointer=pointer+ 1 6 
END WHILE 
RUN syscall($50,regs) 
\(* clear block 

options(8)=paus 
\(* restore window status 

regs.a=l \regs.b=0 

\regs . x= ADDR(options) 
RUN syscall($8E,regs) 
END 



EZ135... 

continued from page 6 

15 PRINTIRGB-DOS only uses 256-byte sec- 
tors. If your hard drive only supports 
512-byte secotrs, RGB-DOS will only use 
half of it. To determine how many 
sectors your drive has, use the HD- 
UTIL.BIN program. I: PRINT 
20 PRINTIDoes your drive use (2)56 byte 
or (5)12 byte sectors?!; 
25 A$=INKEY$:IF A$=I* THEN 25 ELSE IF 
A$=!2" THEN SZ=256 ELSE IF A$=I5" THEN 
SZ=512 ELSE 25 
30 PRINT SZrPRINT 

35 LINEINPUTlHow many total sectors? 
l;A$:IF A$=II THEN 35 

40 IF LEFT$(A$,1)=I$1 THEN TS=VAL 
( I&HI+ RIGHTS (A$,LEN(A$)-D) ELSE 
TS=VAL(A$) 

45 TS=TS-1:IF TS<1 THEN 35 
50 MX=INT(TS/630): PRINT: PRINTiTotal sec- 
tors entered as*TS:PRINT*which is enough 
forlMXIRS-DOS drives. I 
55 IF NX>256 THEN MX=256: PRINTIRGB-DOS 
supports up to 256 RS-DOS drivesper hard 
drive. Any remaining space canbe used 
for an OS-9 partition.!: PRINT 
60 PRINT 

65 PRINTlHow many RS-DOS drives ( 1 - 
IMXD? I;:LINEINPUT A$:IF A$*=IITHEN 65 
70 IF LEFT$(A$,1)=I$I THEN 
DR=VAL<I&HI+RIGHT$<A$,LEN<A$)-1)) ELSE 
DR=VAL(A$) 

75 IF DR<1 OR DR>HX THEN 65 
80 RS=DR*630:0S=TS-RS: PRINT: PRINTlYou 
have requestedlDRIRS-DOS 

drives,I:PRINTItaking upIRSlsectors of 
hard dr i vei: PRINTIspace and 
leavingiOSifor OS-9. I 
85 PRINT: PRINTIIs this acceptable (Y/ 
N)? l; 

90 A$=INKEY$:IF A$=il THEN 90 ELSE IF 
A$=IY1 THEN PRINTIYesil ELSE 
PRINTlNo.I:G0T0 60 

95 RK=(RS*SZ): PRINT: PRINTiRS-DOS 
:IINT(RK/1024/1024)UBb /IRKIKI 
100 0K=(0S*SZ):PRINT10S-9 :iINT(0K/ 

1024/1 024) imb /iOKttOI 
105 PRINT: IF SZ=512 THEN PRINTINOTE: 
Since RGB-DOS does not fully use 512- 
byte sectors, half of the space willbe 
wasted. 1: PRINT: PRINTiALSO: If you are 



not using OS-9 driversthat support 512- 
byte sectors, storage will also be half 
of what is listed. I 

110 0F=TS-RS: PRINT: PRINTfThe RS-DOS par- 
tition will start ati: PRINT Isectorl 
OFiwhich is an offset of :i 
115 L1=INT(0F/65S36) :L2=0F- 

(L1*65536) :0f $=*00000 H :A$=*EX$(L1 ) :A=LBKAS) : 
HID$(OF$ / 3-A,A)=A$:A$=HEX$(L2) : 
A=LEN(A$):MID$(0F$,7-A,A)=A$:PRINT: PRINT 
TAB(12)Ii> $10F$1 <li 
120 PRINT: PRINTiConf igure RGB-DOS now? 

*; 

125 A$=INKEY$:IF A$=ii THEN 125 ELSE IF 

A$=»YI THEN PRINTIYes»I:G0T0 140 

130 PRINT«Nope.I:PRINT:PRINT»Good Luck. 

I hope this program is of use. I 

A lien*: END 

135 END 

140 PRINT: PRINTiLoading "RGB-DOS.BIN* 

i mage . 1; : L0ADM1RGB-D0SI 

145 PRINTlPatching.i 

150 FOR A=0 TO 2: POKE &H3938+A,VAL 

(1&H1+MID$(0F$ / A*2+1 / 2)):NEXT 

155 PRINT: PRINTISaving LOADH compatible 

s RGB-D0S.BIN'.i 

160 SAVEM!RGB-DOSI,&H1FDO,&H3FFF,&H1FDO 

165 PRINT: PRINTISaving EPROH compatible 

v EPR0M.D0SM 

170 SAVEM!EPROH.DOSI,&H2000, 

&H3FFF,&H2000 

175 PRINT: PRINTiComplete. New RGB-DOS 

image is ready. i 

180 END 

This information should give you enough to 
create an EZ135 disk with both RS-DOS and 
OS-9 sections. Ofcourse,OS9PART.BAScan 
be used with any SCSI drive and RGB-DOS 
as well. Note that, for most values, both deci- 
mal and hexidecimal values can be used. Just 
enter a "$" before a hex value. (For example, 
at the 'total sectors" prompt, typing "$40000" 
or "262144" will both work.) 

To be continued... 

In the next issue, I'll discuss using an EZ1 35 
for DECB only and for OS-9 only on a CoCo. 
There will be a couple programs to make this 
a simpler task. Of course that means I have 
two more months to play around ~*2c% 
with the setup until then! Ifldis- \ST\ 
cover anything new, T 11 be sure ^* 
and let you know! 
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OS-9/68K Programming Help Ark systems, usa 

How do you set/get the time??? 

QUESTION: " " ' "* 

(from Steve Wallace <wallace@titan.com> on the Internet): 

I am having a bit of a difficult time with the _os_setime() documentation. 

From p 2-450 of Ultra C Library reference manual: error _code _os_ setime(u_int32 time); _time_ specifies the time. The time 
is stored as the number of seconds since 1 January 1970 Greenwich Mean Time in the form OOhhmmss. 

Then, from p 2-451: errorcode j)s9_setime(u_int32 time, u_int32 date); time is in the format OOhhmmss date is in the format 
yyyymmdd. 

Also note: There are two functions for getting the time called _os_getime() and _os9_getime() where _os9_getime() retrieves a 
Gregorian time as OOhhmmss and date as yyyymmdd or Julian time as seconds since midnight and date as the Julian day number, 
whereby _os_getime() returns the number of seconds since midnight of some date (which, after non-trivial digging turns out to be 
1 January 1970). 

My question, then, is that if I have the time expressed as some number of seconds since some date (for the sake of argument we 
may assume that it is corrected to 1 Jan 1970), how do I set the time/date? The arguments for _os_setime() don't have enough 
hours in one byte to support this... OOhhmmss only allows for 255 hours, which is only 10 days, 15 hours. So this can't be right... Is 
this really a typo, and the argument for _os_setime() is really just the number of seconds since some date (1 Jan 1970), and the 
business about OOhhmmss is a cut and paste error by the tech writer that didn't get caught? Even if it's two bytes, it's still only 
about 7 yrs 5 mos, so even that isn't right. 

Or do I really need to convert the number of seconds that I have to the yyyymmmddd, OOhhmmss format and use _os9_setime()? 
If that's the case, are there routines that can convert between the two, taking into account things like daylight savings time and leap 
years and such? 

ANSWER: 

_os9_getime() and _os9_setime() take two arguments (other than the format specifier and ticks in _os9_getime()), *time of a 
day* in "OOhhmmss" and date in "yyyymmdd." So, hh in time is always between and 23 inclusive. They are different from 
_os_getime() and _os_setimeO which use Unix-style numbers of seconds since a reference time. 

Be careful: OS-9000 VI. 3 or earlier uses midnight of Jan. 1, 1980 UTCas the reference though OS-9 uses Jan. 1, 1970 UTC. 
Another glitche is that the manual uses a "byte 3.. 1" notation to fool you about endian. 

Don't be fooled. The actual bye positions agree to natural feelings: say, 00 is always the MSB and ss is always the LSB u_ 
"OOhhmmss," and they are neither the "first byte" nor "last byte." 

Dai 

ARK Systems USA 

P.O. Box 23, Santa Clara, CA 

95052-0023 

http://www.arkusa.com 

Phone:(408)244-5358 

mailto:arkusa@arkusa.com 



BasicBoost : 6309 port of Basic09's RunB module. Packed programs are 10% to 15% faster (varies with functions used)! 

ScreenBoost: 6309 version of Level Et screen drivers. Noticeably speeds up most functions! Adds support for up to 200 graphic lines 
and 28 by 128 column text screens, plus horizontal scrolling. New commands to manipulate graphic fonts and one that allows 
programs to move and resize the window in which they run. 

$10 each or $16 for the pair 

HSLINK: Null-modem file transfers between a CoCo and any other computer Uses CoCo printer port — no special hardware 
required! ASCII and Xmodem transfers up to 19,200 bps - 57,600 bps with 6309! Cables can be made on request (specify ends 
needed) or use your own null-modem cables. 

$14.95 or $24.95 with cable 

Prices are in US dollars. Call or write for Canadian dollar prices. 
Add $3 US, $5 Canada for shipping and handling 




C Dekker 

RR#4 
Centreville, NB EOJ 1H0 

CANADA Phone 506-276^841 
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EDTASM6309 v2.02 - $35.00 

Patches Tandy's Disk EDTASM to support Hitachi 6309 codes! 
Supports ail CoCo models, including stock 6809 models. CoCo 3 
version uses 80 column screen, runs at 2MHz. YOU MUST HAVE 
A COPY OF DISK EDTASM. This is a PATCH ONLY! It will not 
work with ''disk patched" cartridge EDTASM 

CC3FAX - S3S.00 

Receive and print weather fascimile maps from shortwave! The 
US weather service sends them all the timet Requires 512K CoCo3 
and shortwave receiver. Instructions for simple cable included. 

HRSDOS - $25.00 

Move programs and data between DECB and OS-9 disks! Sup- 
ports RGB-DOS - move files easily between DECB and OS-9 par- 
titions! No modifications to OS-9 modules required. 

DECB SmartWatch Drivers - $20.00 

Access your SmartWatch from DECB! Adds function to BASIC 
(DATES) for accessing date and time. Only $15.00 with any other 
purchase! 

RGBOOST - $15.00 

Make the most of your Hitachi 6309 by using it with DECB! Uses 
6309 functions for up to 15% gain in speed. Compatible with ail 
programs tested to date! Only S10 with any other purchase! 

Robert Gault 

632 N. Renaud 

Groeee ?o'\nte Woods, Ml 46233 

313-661-0335 

Please add $4 S&H per order 




1629 South 61st Street 

Milwaukee, Wl 53214-5055 

(pullandQomnifest.uwni.edu) 



That thing that Tandy calls a serial port on the CoCo 
has always been a problem. It was designed with 
minimal cost in mind, and never upgraded. Even 
Tandy tried to fix it with their RS-232 Pak f but even it 
was only half done! Our Fast 232 port uses a 1 6 byte 
buffer at alleviate missed characters at any speed and 
also has ALL RS-232 lines implemented. It is easy to 
set up with jumpers for different addresses. A 
daughterboard can be purchased to easily add a 
second fast serial port! And all this in a cartridge the 
size of a ROM Pak! 6809 and 6309 OS-9 drivers in- 
cluded. Completely supports up to 57,600 bps, lim- 
ited support for 1 1 5,000 bps. 

Fast 232 - $79.95 
Daughter Board - $45.00 

Check with us for complete disk drive systems, 
misc. hardware items, hardware repairs, and hard 
to find new and used CoCo software! 



m 



Northern Xposure 

CoCo OS-9: 

NitrOS9 - Upgrade OS-9 Level H for the CoCo to a new 
level of performance! Requires Hitachi 6309. Call or write 
for upgrade info. $29.95 

Shanghai:OS-9 or Thexder:OS-9 
Send manual or ROM Pak to prove ownership. Transfers 
and modifies code to run under OS-9! $29.95 

Rusty - Launch DECB programs from OS-9! $20.00 
SCSISYS 2.2 - SCSI hard drive drivers... fast! Supports 
256 or 5 12 byte sector drives! $25.00 

Hitachi 6309 CPU $15 00 

SIMM 512K Memory Upgrade - runs cooler! 
W/5 12K - $44.95 w/o memory - $39.95 

OS-9/68000: 

OS Term 68K - v2.2teruiinal program. TTY/ANSI/ 

VTlOO/KWindows support $50.00 

7 Greensboro Cres 

Ottawa, ON KIT 1W6 

CANADA 

All prices in US funds. Check or Money Order only. 
Prices include S&H. 
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EDTASM6309 v2.02 - $35.00 

Patches Tandy's Disk EDTASM to support Hitachi 6309 codes! 
Supports all CoCo models, including stock 6809 models. CoCo 3 
version uses 80 column screen, runs at 2MHz. YOU MUST HAVE 
A COPY OF DISK EDTASM. This is a PATCH ONLY! tt will not 
work with "disk patched" cartridge EDTASM 

CC3FAX - $35.00 

Receive and print weather fascimile maps from shortwave! The 
US weather service sends them all the time! Requires 512K. CoCo3 
and shortwave receiver. Instructions for simple cable included. 

HRSPOS - $25.00 

Move programs and data between DECB and OS-9 disks! Sup- 
ports RGB-DOS - move files easily between DECB and OS-9 par- 
titions! No modifications to OS-9 modules required. 

DECB SmartWatch Drivers - $20.00 

Access your SmartWatch from DECB! Adds function to BASIC 
(DATES) for accessing date and time. Only $15.00 with any other 
purchase! 

RGBOOST - $15.00 

Make the most of your Hitachi 6309 by using it with DECB! Uses 
6309 functions for up to 15% gain in speed. Compatible with all 
programs tested to date! Only $10 with any other purchase! 

Robert Gau\t 

S32 N. Kenaud 

Groeee Pointa Woods, Ml 45236 

313-S61-0335 

Please add $4 S&H per order 
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1629 South 61st Street 

Milwaukee, Wl 53214-5055 

(pultand@omnifest.uwm.edu) 



That thing that Tandy calls a serial port on the CoCo 
has always been a problem. It was designed with 
minimal cost in mind, and never upgraded. Even 
Tandy tried to fix it with their RS-232 Pak, but even it 
was only half done! Our Fast 232 port uses a 1 6 byte 
buffer at alleviate missed characters at any speed and 
also has ALL RS-232 lines implemented. It is easy to 
set up with jumpers for different addresses. A 
daughterboard can be purchased to easily add a 
second fast serial port! And all this in a cartridge the 
size of a ROM Pak! 6809 and 6309 OS-9 drivers in- 
cluded. Completely supports up to 57,600 bps, lim- 
ited support for 1 15,000 bps. 

Fast 232 - $79.95 
Daughter Board - $45.00 

Check with us for complete disk drive systems, 
misc. hardware items, hardware repairs, and hard 
to find new and used CoCo software/ 



Northern Xposurel w J| 

CoCo OS-9: ■— 

NitrOS9 - Upgrade OS-9 Level II for the CoCo to a new 
level of performance! Requires Hitachi 6309. Call or write 
for upgrade info. $29.95 

Shanghai:OS-9 or Thexder:OS-9 
Send manual or ROM Pak to prove ownership. Transfers 
and modifies code to run under OS-9! $29.95 

Rusty - Launch DECB programs from OS-9! $20.00 
SCSISYS 2.2 - SCSI hard drive drivers... fast! Supports 
256 or 512 byte sector drives! $25.00 

Hitachi 6309 CPU $15 00 

SIMM 512K Memory Upgrade - runs cooler! 
W/5 12K - $44.95 w/o memory - $39.95 

OS-9/68000: 

OSTerm 68K - v2.2terminal program TTY/ANSI/ 

VTlOO/KWindows support $50.00 

7 Greensboro Cres 

Ottawa, ON KIT 1W6 

CANADA 

All prices in US funds. Check or Money Order only. 
Prices include S&H. 
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What are you waiting for? 

Get your friends to subscribe to 

the only magazine that still supports 

the Tandy Color Computer... 

"the world of 68' micros" 1 . 

The more people who want the support, 

the longer it will be here! 
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Wittman Computer Products 

HARDWARE * SOFTWARE * CONSULTING 
We Offer Gift Certificates 

Software 

Game Pack - Sea Battle, Minefield, KnightsBridge, Othello, & Yahtzee $30 mm/i 

$25 coco 
Variations of Solitaire - Pyramid, Klondike, Spider, Poker, & Canfield $30 mm/1 

$25 coco 
Gold Runner 2000 - KWindows game $35 mm/1 

KChess - GNU Chess with KWindows GUI $25 mm/1 

GNU Chess Source Code Disk $5 osk 

CirCad - Circuitry CAD program with PostScript output $80 mm/i 

DeskTamer v2.0 - Personal Information Manager $65 mm/i 

LaTerm / LaDial - GUI terminal package with script auto-dialing $65 mm/i 

LaPhone / LaFax - GUI voice, fax & address database manager $65 mm/i 

InfoXPress - auto-dial and download messages $75 osk 

$55coco/os9 

X-1 Home Controller - Program for monitoring your X-1 system $40 mm/i 

M6809 - CoCo OS-9 emulator $65 osk 

TVP Point of Sale - Fully integrated multi-user accounting, 
inventory, ordering, and cash drawer. $CALL 

Hardware 

WCP306 single board computer with 16 bit PC/AT I/O bus, MC68306 CPU running 
at 16.67MHz (code compatible with 68000), OS-9 v3.0, MGR GUI, many utilities. 

3 Slot board - $400 5 Slot board - $425 

We also carry Point-of-Sale equipment, hard and floppy drives, cases and power 
supplies, data/fax modems, keyboards, memory, mice, and more! 

For more details, write or call for a catalog. 

Wittman Computer Products 

39 South Lake Avenue 

Bergen, NY 14416 

716-494-1506 

e-mail: ww21 50@acspr1 .acs.brockport.edu 

(acspr "number 1* - lowercase I won't go through!) 



